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Watcom G/¢++ 100 


The new Watcom C/C++ 10.0 
development system simplifies and acceler- 
ates development of high-performance, 

multi-platform 16- and 32-bit applications. 
Watcom C/C++ 10.0 delivers productivity 
and performance, combining our state-of- 
the-art compiler technology with a new, 
integrated development environment 
(IDE) and Sopupeebctare set of tools. © 


New Integrate | Deve lopment 

Environm ent a an tele “The new IDE is 
built to simplify the ptiee te of real-world 
application development and make it easy to exploit 
the high-performance, multi-platform power of 
Watcom C/C++ 10.0. In a single “project” you can 
build multiple EXEs, DLLs, and LIBs, targeting 
several different platforms. The IDE simplifies each 
stage of development from compiling and linking to 
debugging and performance tuning. The package 
includes versions of the IDE and tools for all three host 
platforms (Windows 3.x, OS/2 2.x and Windows NT), 
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e New integrated Peisoutian environment 
hosted on Windows, OS/2 and Windows NT 

« Comprehensive suite of multi-platform 
development tools including debugger, 
browser, profiler and more 

* Professional source editor, resource editors, 
testing and monitoring tools hosted on 
Windows and Windows NT 

* Target Platforms include: 
16-bit: DOS * Windows 3.x * OS/2 1.x 


Watcom C/C++ 10.0 includes a source editor with syntax 32-bit: Extended DOS » Windows NT 
highlighting, a suite of resource editors, testing and e Win32s « OS/2 2.x * 32-bit 
monitoring tools for Windows 3.x and NT development. Windows 3.x * Novell NLM 

* AutoCAD ADS/ADI 
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Suggested Retail Price: 


Watcom C/C++ 10.0 





The advanced multi-platform debugger accelerates the 
development cycie by increasing the bandwidth between 
ou and your application. , Hf == 
you and your app 00-2 P| Ch./ 1665 
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Watcom International 415 Phillip Si Street, Waterloo, Ontario, Canada N2L 3X2 Telephone (519) 886-3700 Fax (519) 747-4971 
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Watcom C/C++ 10.0 CD-ROM Edition earns 





Tw 


(CO-ROM with on-line documentation) dud 
Watcom C/C++ 10.0 ee 
(CD-ROM with printed documentation) CA Ah 
Upgrades: 


(for owners of Watcom GiG++” or Watcam GiG++" y9.5) 


CD-ROM Upgrade Edition $1 4Q* 


ACCELERATE 


Your C and C++ 
Application Development 






jatforms in a Single 





d Aas of applications targeting an 
Incredible array of platforms: DOS, Windows 
5.x, OS/2 1.x, 32-bit DOS (includes royalty-free 


JOS extender), OS/2 2.x, Windows NT, Win32s, 


42-bit Windows 3.x and Novell NLMs. To 
Maximize the potential on individual 


is extensive support is amplified by the cross- 


platform capabilities of the IDE and tools, which enable 
building applications for a wide range of target 
environments from any of the host systems. 
Optimization Technology watcom C/C++ 10.0 
combines both 16- and 32-bit compilers ina single package, providing 
you with the industry-leading optimizing compiler team. PC Magazine 
tested performance of industry standard C and C++ compilers and said: 
“the fastest executables created during testing came from Watcom C/C++, 
Version 9.5, while the 16-bit version of the same compiler produced the smallest 
executables”', Now, with Watcom C/C++10.0, this competitive advantage is 
delivered with our easy-to-use development environment and tools. 


Sea Watcom C/C++ 10.0 delivers all this in a single packaqe! 
| oh) —- fe Sar eee ‘ a | . 


* Both 16-bit and 32-bit compilers for C and C++, 
the industry's best code optimizer, faster compile 
times with pre-compiled headers, C++ supports 
templates, exception handling and the Microsoft 
Foundation Class library (MFC) 

* Licensed components from: 

* Microsoft Windows 3.1 SDK 
* Microsoft Windows NT SDK 
* Novell NLM SDK v4.0 
* |BM OS/2 Toolkit v2.1 
* Microsoft MFC Class library 

« Includes Rational System's DOS/4GW 32-bit 
DOS extender with royalty-free distribution 

« Significantly expanded and revised 
on-line documentation 

«And more! 
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Watcom 


A Powersoft Company 


* Price in US dollars. Does not include freight and taxes where applicable. Authorized dealers may sall for less. $199 Special Offer is available until October 31, 1994. Watcom and the Lightning Device are trademarks of Watcom International Corp 
DO0S4G Is a trademark of Rational Systems Inc. Other trademarks are properties of their respective owners. Copyright 1994 Watcom International Corp. Pt Magazine, March 29, 19 
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CKd age Watcom as 10 0) supports 


latforms, Watcom C/C++ 10.0 extends the 
Capabilities of the core, multi-platform toolset 
» With platform-specific tools, SDKs and libraries. 








“We chose PVCS because the 
vendors of our new develop- 
ment tools recommended it 
They told us Software 
Configuration Management 
was a necessity for productive 
development on the LAN. 

I'm glad we listened 

to them. PVCS has proven 

to be invaluable. We now 
have superb control over all 
































development efforts.” 
pment Tool Vendors Agree: PYUS 
Selected Vendors: PVCS Developer's Toolkit Leverage Your 
Borland International IDE ee rove Tool Investment with PVCS 
Digitalk Team/V dicate Casilinumation There’s a reason why all major Client/Server 
Manager Builder and LAN development vendors have formed 
Gupta Technologies, Inc. alliances with INTERSOLV. It's PVCS— 
HP SoftBench Pvcs _ PvCS | the standard for Software Configuration 
| eta Production — M he LAN It’ ‘tal 
IBM SDE/6000 Pp Gateway | , anagement on the jah tsavita 
IBM 0S/2 = — ' ingredient for productive LAN development. 
Prodactive Unis Every Major Development Tool Vendor Partners with Intersolv 
The list on the left is only partial. PVCS is available in all the environments 
Micro Focus COBOL developers work in—today and tomorrow. That means less training-you don’t 
Microsoft Visual C++ have to learn another SCM tool if there’s a change. That means more efficient 
Microsoft PWB development and easily enforced standards. It means consistent audit trails for all 
Peau aatk Poworthulldor development, and the ability to correct errors and anomalies at any time. 
SCO Serious Application Development Demands PVCS 
sundS The trend is clear. Important applications in your company are moving to the LAN. 
They need the control and reliability that PVCS provides. Your development tool 
SunSoft vendors know that-that’s why they recommend PVCS. e 
Solaris ) 
Symantec C++ IDDE Call Today for 
rae posed ate More Information: | 
800-547-PVCS Ext. INTERSOLV 
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We've always believed Micro Focus COBOL Workbench® 
is the best in the world. Now you’ve confirmed it by unequivocally 
Zh, = placing it first in the 1993 Computerworld PC Software 
WEL) Brand Preference survey. 

X\ 7 You voted COBOL Workbench as Best Technology 
—— and Easy to Use. That's not all. Workbench has also 


on the workstation. Programmers find Workbench puts them 
directly in control of their development environment, delivering 


ms, 





\, quality business applications on time and on budget. 
GOTT if it isn’t Micro Focus COBOL Workbench, it isn’t in 
y/ the running, That's not just our opinion, it’s yours. 

: For your free copy of the 1993 Computerworld survey, 
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won top honors in Price/Performance, Best Documentation, Plan 
to Buy, and most importantly, you chose Micro Focus as the 


company you Prefer to do Business With. According to you there 
was no contest. 


ST Tae oe 


or for more information, call 800-MF-COBOL, (800-872-6265). 
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MICRO FOCUS 


Micro Focus Inc. 2465 East Bayshore Road, Palo Alto, CA 94303. Tel. (415) 856 4161. 


Not surprising really. There is no better technology for 
developing new systems or re-engineering existing applications 





Micro Focus and COBOL Workbench are registered trademarks of Micto Focus, Inc. All other trademarks are property of their respective companies 


GSA Contract Number GSO00K93AGS6403. In Canada call IBM Canada at 1-800-465-]234. 
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SourceLink v2.0 
by One Up Corporation 


SourceLink, the ultimate 32-bit programming 
development tool, combines the functionality 
of hyperlink source code access, a fully- 
functional editor and extensive file manipula- 
tion utilities into one very powerful toolset. 
Now you can find code, change code, spawn 
compiles and hyperlink directly to the source 
of error quickly and efficiently. Features 
point & click source code navigation and automatic generation of 
function call trees. 


List: $299 Ours: $215 FAXcetera #: 6005-0003 








event-driven programming, message passing, 


behind the scenes. Combines a structured 


Call for a 
FREE 
Catalog! 





by Computer Associates CA-REALIZER 


Defines a new generation of development 
tools that handles the mechanics of 





process sharing and other complexities 


superset of BASIC extended to access 
and OS/2 objects and resources. 
CA-Realizer will help you create spread- 





sheets, charts, text editors, animation, 
graphics tablets and user-friendly forms from tools that can be 


created and manipulated by simple commands. 
List: $247 Ours: $79* FAXcetera #: 1004-0008 
* While supplies last. 





Window Washer v2.0 

by One Up Corporation 

The latest version of the best-selling 32-bit 
screen saver for OS/2, with full system pass- 
word security and the most complete monitor 
burn-in protection available today. Version 2.0 
features many exciting animated effects, digital 
video and audio (plays CD's, MIDI or WAV files 
with program effects). Also utilizes TIF, GIF, 
BMP, & PCX backgrounds. 


Ours: $29 FAX cetera #: 6005-0001 





SMART—Source 
Migration Analysis 
Reporting Toolset 

by One Up Corporation 


Hailed by IBM and other industry 
leaders as a premier source code 
conversion tool, SMART produces native 32-bit source code for OS/2. 
SMART runs on O5/2 2.1 or above and is used for the migration of 
‘Cc’ and C++ source code from Windows 16-bit to OS/2 32-bit or 
OS/2 16-bit to OS/2 32-bit, depending upon the licensed, installed 
tables. The result is a faster. more tightly integrated application that 
does not require any emulation or run-time modules. 


List: 514,995 Ours: CALL FAX¢etera #: 6005-0004 





object-Menu 
by Lifeboat Publishing 


object-Menu is the way to quickly create 


f 


powerful object-oriented applications. Built-in) =. pees 
aesthetics make it easy to create interface = = 
styling such as Windows, Motif, or your 4 C++ 
own custom design. Portability to DOS, <= 

Windows/NT and OS/2 enables you to offer = Ba 


your product to multiple target markets with a 

single engineering effort. And, object-Menu's 

intuitive architecture, straightforward methodology and Visual 
Design tool significantly speed GUI development to allow you more 
time to focus on your application. 


List: $299 Ours: $269 FAXcetera #: 2088-0003 
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database for use in the application. Key 





WATCOM VXeRExx & 
WATCOM SQL for OS/2 
by WATCOM 


WATCOM” VX*RExx is an award-winning easy to 
use visual development environment for creating 
applications that leverage the capabilities of 
OS/2 2.x and exploit the Presentation Manager 
graphical user interface. WATCOM”™ SQL for 
OS/2 is a high performance SQL Client/Server 
DBMS for OS/2 which includes a standalone single-user SQL data- 
base server as well as a variety of interfaces to access WATCOM SQL 
from many popular OS/2, Windows and DOS applications. 





WATCOM SQL for OS/2 also includes a high-level interface for Rexx. 


allowing easy access from WATCOM VX*Rexx 
applications. Using the VX*Rexx visual design- 
er, you can graphically create Presentation 
Manager interface objects, quickly customize 
their properties, and easily attach Rexx 
procedures to the objects using powerful drag- 
and-drop programming techniques. These pro- 
cedures can easily retrieve information from the 





features of WATCOM SQL for OS/2 include: 
referential integrity; bi-directional, scrollable, 
updatable cursors; row-level locking; ANSI SQL 
and IBM SAA compatible; multiple simultaneous application connec- 
tions; symmetric multi-threading of concurrent requests; and the 
ability to import data from popular file formats including DBF. 
SPECIAL BUNDLE OFFER! 

Only: $349 FAXcetera #: 1683-0019 


GUARANTEED BEST PRICES! (Call for details) 
To order call: 800-445-7899 

Corporate: 800 441-1511 

FAX: 908 389-9227 

International: 908 389-9228 

Customer Service: 389-9229 

Programmer's Paradise Italia: 

39-2-96702855 

For more information on the products 

featured on this page call— 


FAX cre ®: (908) 389-8173 


1163 Shrewsbury Avenue 
Shrewsbury, NJ O7702 

* All prices are subject to change without notice. 

® Call for details on return policy and shipping charges. 
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This is the third of a series showing how a replacement list box smashes the 64K barrier and illustrates 
new methods of control design. In this issue, we cover the basics of text editing. By MARK A. BENGE 
and MATT SMITH 


The Forbidden Text 
/ 





Mark A. Benge 





Matt Smith 





n previous columns, we began the 
presentation of a 32-bit replace- 
ment to the list box control. We 
mentioned that we would add direct 
editing to the list box. Before we 
attempt to do that, we will take a 
detour into the basics of text editing. 
To illustrate this side trip, we develop 
a replacement to the entry field. If you 
understand the basics of editing text, it 
will be much easier to add this support 
to the list box. 





WHAT'S EVERYBODY AFRAID OF? 

It is extremely difficult to find any books 
or articles that discuss the issue of text 
editing within a graphical environment. 
Just because the default text is propor- 
tional doesn’t mean we should run away 
and hide. It’s easy to create a text input 
mechanism for fonts of fixed increments, 
like Courier, but what are you supposed 
to do when it is a proportional font? You 
would think that by this time someone 
would have documented the simple—yes, 
simple—tricks that allow you to do it. 


BACK TO THE FONT BASICS 

Why hasn't the issue of text editing been 
adequately documented? Basically, it’s 
because each of the letters has a different 
width. Figure 1 shows the fonts used 
within an OS/2 command window. The 


font widths are all the same, and each 
font increment is a multiple of that width. 
Look at Figure 2, which shows the 
system font. Some font widths are the 
same, while others are larger or smaller— 
hence, the big scary monster. In each fig- 
ure, the running position is shown across 
the top of the font, and the width of each 
character is shown at the bottom. 


WHERE DID THAT MOUSE GO? 

Let’s assume we use the traditional 
method to determine the character 
index based on the location on which 
the mouse pointer was clicked. If the 
pointer was clicked in position 112, we 
would use the following formula to 
determine which character is selected: 


xClick / CharWidth = CharIndex 
Therefore, 112 / 12 = 9 or the character j. 


What happens if we use this 
formula with a proportionally spaced 
font? If the average character width is 8, 
the formula yields 112 / 8 = 14 or the char- 
acter 0, which is wrong. It should be the 
character m. 


TRANSLATION, PLEASE 

What's the trick? The answer is one of two 
methods. The first method, which is the 
fastest but contains a memory overhead, 


OS/2 DEVELOPER 


is to build an array of points based on the 
text string. Conveniently, there is a func- 
tion within the GPI that will do this for us. 

GpiQueryCharStringPos is used to query 
the starting point for each character 
within a string passed to the function. 
The points are returned in an array of 
POINTL structures that is passed to the 
API. We use this array to determine the 
character position. 

In the previous example, if we 
passed to the function the exact charac- 
ter string shown, the points would be 
returned in the POINTL array, and we 
would only have to look at each array 
element and the next element to deter- 
mine if the point is between each. If it is, 
we have found the character. 

The alternate method is to use the 
GpiQueryTextBox or the WinDrawlext APIs, 
while at the same time shifting the num- 
ber of characters you view. The alterna- 
tive, while a memory miser, can be much 
slower, depending on the method you 
implement to perform the calculations. 
Remember, every time you invoke a sys- 
tem API, you don’t know how many lines 
of code that API will execute. 

The fastest method of performing 






Figure 1. Fixed font metrics 





Figure 2. Proportional font metrics 
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the translation from the point to the 
character index is to perform a simple 
binary search until the character cell is 
located. Both translation methods could 
employ the technique. 

In our replacement for the entry field, 
we employ the first method of using the 
GpiQueryCharStringPos and the binary search 
technique. 


A MATTER OF SELECTION 
How do we translate this into reality 
with the replacement entry field? Quite 
easily, actually. Figuring out the charac- 
ter index is a piece of cake; handling the 
selection mechanism is a different story. 
Figure 3 shows the basic design of 
the entry field. In terms of character 
selection, we are concerned only with 
horizontal locations. This is due to the 
nature of the control—that being a sin- 
gle line entry field. A simple click of the 
left mouse button causes us to look up 
the character index based on that loca- 
tion. One subtlety is how each click is 
translated to the final character index. 
When the mouse pointer is clicked, 
the look-up routine determines the char- 
acter over which the click occurred. To 
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lales from the Trenches 


A Public Service Announcement: When we started develop- 
ing the replacement entry field, we decided to throw in cursor 
management calls. Bad move...or so it seemed. Although we 
specified in the WinCreateCursor call that the cursor should flash, 
it would not flash. For three solid days, we smacked our heads 
against the display, desperately trying to figure out what we were 
doing wrong. We finally figured it out. 

We set a breakpoint on the WH_TIMER message to see if it was 
intercepting a timer message for the flashing of the cursor. Sure 
enough, the breakpoint was hit. After looking at the timer ID, we 
knew it wasn't one of ours that was set off by mistake. Because of 
the sheer diligence with which we have scoured the Presentation 
Manager headers over the past few years, we understood that this 
idea made sense. Buried within the PMWIN.H header are the IDs of 
four timers used within Presentation Manager. 

One of them is TID_CURSOR, which was the ID of the timer we 
encountered at the breakpoint. The solution to getting the cursor to 
flash again? We put in a couple of lines of code that check the ID of 
the timer, determine whether it is the cursor ID, and pass the mes- 
sage on through to the WinDefaultWindowProc. Guess what? This 
isn t documented anywhere in the Presentation Manager documen- 
tation. If you follow the WM_TIMER reference, you are supposed to 
return zero (0). Maybe the Presentation Manager ID groups are 
spending too much time at the beach in Boca. 


facilitate drag selection, each charac- 
ter is divided into two zones. The 
front half of the character is used to 
select the character. The back half of 
the character is used to select the 
next character. Hence, you have a 
conceptual click zone like that 
shown in Figure 3. 

Why is this done? The answer is 
based simply on boundary condi- 
tions. This mechanism makes for a 
smoother selection when clicking on 
a character. It also makes the drag- 
ging selection mechanism appear 
smoother. Who said appearances 
aren't everything? 


ANCHORS AWAY 

The selection of text is based on a 
zone with an anchor point. The 
zone starting and ending points 


make sense. What is the anchor all 
about? 

The drag selection of the text 
can be performed in either direc- 
tion: left to right or right to left. 
The anchor is the point on which 
the selection zone flips when the 
drag selection changes from one 
direction and reverses to the other. 

This allows the starting and 
ending selection points to be non- 
directional in nature. The anchor is 
always based on the initial mouse 
click position. Therefore, when the 
mouse is dragged from left to right, 
the anchor is, in effect, the starting 
position of the selection zone. If the 
mouse is suddenly dragged from 
right to left and in front of the old 
starting location, the anchor is now, 
in effect, the ending position. 
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When you use this technique, 
you ensure a smooth transition 
from one zone to the other. 

Depending on the direction of 
the dragging, the cursor is located 
either at the beginning or the end 
of the selection zone. When drag- 
ging from left to right, the cursor 
always ends up at the end of the 
zone (this is where the mouse 
release occurred). The cursor is 
placed at the beginning of the zone 
when the dragging is right to left. 


CHARACTER REFERENCES, PLEASE 
You can perform different opera- 
tions on this selection zone. The 
most common action is deleting 
selected text and replacing it with 
a text string (a paste operation) or 
a single character (a keyboard 
character keystroke). You also 
could cut or copy the selected text 
to the clipboard if you desire. 

By default, the entry field 
begins in insert mode. When no 
selection zone is active, the cursor 
location becomes the focus of 
interest. Any text pasted into the 
entry field causes the text to the 
right of the cursor to be pushed to 
the right. A simple character key- 
stroke from the keyboard achieves 
the same result. 

When the entry field is in over- 
type mode, the character posi- 
tioned immediately after the cur- 
sor is selected. If a character 
keystroke is performed, the 
selected character is replaced with 
the new one. 


SCROLLING THROUGH THE PARK 
Once we have the basics in place, 
the fun begins. Usually, when you 
perform drag selection, you need 
to force the text that is not dis- 
played to be shown. 

The most often used technique 
is to move the mouse pointer to 
the left or the right of the entry 
field, while the left mouse button 
is continuously depressed. Once 
outside the left or right limits, the 
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idea is to allow the scrolling of the 
contents of the entry field in that 
direction. 

What happens when the 
mouse isn’t within the entry field 
window? In our previous article, 
“Scrolling Through the Park” 
(Winter 1993), we discussed the 
technique of capturing the mouse 
using WinSetCapture, such that when 
the mouse is outside the confines 
of our window we still receive the 
movements of the mouse pointer. 
But what if the mouse isn’t mov- 
ing? Tick, tock, tick, tock... 

Yes, we rely on a timer that we 
start for the scrolling. Here, we are 
performing more magic tricks. 

When we start the scrolling 
through the timer, we use a 
slower time period. Once the first 
timer message for the scrolling is 
received, we halve the time so 
that the scrolling seems to imme- 
diately speed up. This effectively 
gives the drag selection a 
smoother look. 


SHOWING OFF 
It is difficult to display the selec- 
tions within the entry field. Here, 
different conditions apply. Re- 
ferring again to Figure 3, notice 
that the text is divided essentially 
into three display zones. The first 
part is displayed normally. The 
second part is displayed with 
highlighting. And the last part is 
shown normally. 

Unfortunately, there is no API 
within OS/2 Presentation Manager 
that allows us to display text in this 





Figure 3. Entry field design 
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fashion (but we wish there was!). 
You must design the display rou- 
tines so they subdivide the text into 
the three component parts, such 
that the drawing appears sequen- 
tially. If you don’t do this, you may 
get a rougher drawing of the text in 
which portions appear to flash. 

When you take into considera- 
tion the effects of offsetting the 
starting point of the scrolled text, 
things do become very interesting. 

Basically, the drawing compo- 
nents of the entry field are divided 
into different drawing routines. 
Each routine is designed for speed 
instead of a general purpose engine. 

Since it is so frequently used, 
this area’ can be continuously 
reworked so that every ounce of 
power is squeezed out. 


WHAT, YOU DON'T LIKE 

THE MULTILINE EDIT CONTROL? 

With this entry field replacement, 
you now have the basis to imple- 
ment many different editing compo- 
nents. In our column that will 
appear in OS/2 Developer’s Novem- 
ber/December 1994 issue, we will 
take the principles of the entry field 
and apply them to the list box. 

How could we further enhance 
this control? What about replacing 
the multiline edit control? Rather 
than replace it by providing exactly 
the same functionality, we could 
provide an enhanced entry field 
that can handle multiple lines. 

This latter approach seems to 
make more sense. Here, you would 
just rely on the idea of \n separat- 


_ = 
= 
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ing each line within the control. 
The scroll bars could be provided 
to allow scrolling similar to that 
found in the multiline edit control. 

By providing a few messages 
and allowing the entry field to have 
additional lines, you could easily 
create your own multiline edit con- 
trol without much grief. It’s easy 
now that you know how to trans- 
late that mouse click into a charac- 
ter selection. 

In a future column, we will 
provide answers to your Pre- 
sentation Manager programming 
questions. If you have a problem 
you would like us to address, 
please contact us at our e-mail 
addresses. 


Mark A. Benge, /BM Software Solutions, 
Cary, N.C., is a staff programmer who joined 
IBM in 1989 and has worked on various CUA 
‘91 controls for OS/2 2.x. He works in IBM 
user interface class library development, 
where he was involved in the implementa- 
tion of C++ classes for drag and drop in C 
SetH 2.1. Benge has a B.S. in computer sci- 
ence fram Western Carolina University. He 
can be reached on CompuServe at 
73532,2063 and on Internet at 
banzai@vnet.ibm.com. 


Matt Smith, Prominare Inc., Toronto, Ont., 
Canada, is lead architect for the Prominare 
Development System, an OS/2 2.x 
advanced GUI development environment. 
He has been actively involved with OS/2 
since 1988 and cofounded Prominare in 
1990. Smith has a degree in architecture 
from the University of Waterloo. He can be 
reached on Internet at prominar.io.org. 
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A natural gas company discovers that moving to OS/2 doesn't mean abandoning years of COBOL 
experience. By BRIAN PROFFIT 


Utility Company Adds 
Power with OS/2 
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ow do you update ancient main- 

frame COBOL environments to 

provide better productivity and 
lower maintenance costs? This is a prob- 
lem many companies now face, Questar 
Service Corp., which provides informa- 
tion technology services to all branches 
of the Questar Corp. holding company, 
knew it needed to make changes. But 
going from a 3270 environment to a 
client/server solution with no down- 
time and minimum risk is challenging. 





CUSTOMER INFORMATION SYSTEMS 

For utility companies, customer informa- 
tion systems are key. Questar’s customer 
information system covers straightfor- 
ward name and address information kept 
by other industries. It also covers other 
aspects of the natural gas industry neces- 
sary for servicing more than a half-mil- 
lion customers in the northwest from its 
Salt Lake City headquarters. Questar 
Service employs over 200 people to han- 
dle the data processing needs of this orga- 
nization. Since 1966, its customer infor- 
mation system has grown to over one 
million lines of mainframe COBOL code, 
covering data access and manipulation 
functions for customers, natural gas dis- 
tribution, marketing, accounting, and the 
maze of required government regulatory 
information. 


Over time, of course, Questar 
patched and added to the system. 
Maintenance became a nightmare. Jerry 
Edwards, director of Data Processing, 
reports that maintenance alone was 
costing around $2 million per year. 

“Adding five characters to an 
address field required changing over 
300 programs, took nearly a year, and 
cost a horrendous amount of money,” 
Edwards says. Clearly, a change was 
needed. 


NEW DEVELOPMENT PROCESS, 

NEW BUSINESS PROCESS 

In analyzing the existing spaghetti code, 
Questar discovered that the developers 
alone couldn’t be blamed. Like most 
companies, Questar’s business 
processes had also been added to and 
patched over time, leading to needless 
complexity and duplication of effort. To 
develop a clean, new information sys- 
tem, it also made the commitment to 
reengineer its business. 

This decision made changes even 
more risky. By moving users from one 
system to another, Questar faced many 
potential problems, such as user diffi- 
culties and bugs, during the break-in 
period as the new code was exercised. 
Changing the business process at the 
same time doesn’t double the risk; it 
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squares it. To lower the risk, Questar 
chose to migrate to the new level one 
piece at a time. 

“We looked at the 54 subsystems 
containing around 700 programs and 
broke the whole project down into 
chunks that could be written and 
tested in no more than 90 days,” 
Edwards says. “That way, the changes 
to the users would come in small, man- 
ageable pieces, and we could reengi- 
neer the business at the same time.” 

For the business changes, Questar 
decided to learn from the best. “We 
looked at companies all across the 
country to see how they did things,” 
Edwards reports. “At each phase, we 
implemented the best technique we 
had found among them—changing the 
way the business did the process 
before we introduced the new technol- 
ogy. We redo things to remove duplica- 
tions, for example. That has cost-justi- 
fied the project all by itself.” 

This migration technique helped 
dictate Questar’s choice of PC plat- 
form. “We looked at Windows, OS/2, 
OSF, and X Windows,” recalls 
Edwards. “We found that Windows 
just didn’t have the horsepower and 
wasn't robust enough for a mission- 
critical application. Plus, the response 
time wasn’t sufficient, nor was the 
crash protection. We didn’t feel that 
OSF or X Windows was going to be 
mainstream enough. 

“We decided on OS/2 for several 
reasons. A big [reason] was its ability 
to run DOS software so well. That 
allowed us to continue running our 
3270 emulators well while users began 
using OS/2 programs.” 

They're also exploiting OS/2's 
ability to run programs written for 
DOS and Windows in other ways. For 
example, they’ve developed a new 
Executive Information System using 
Visual Basic. 





“We have automatic links to Dow 
Jones, getting stock information every 
hour automatically and doing graphic 
comparisons,” says Edwards. “We also 
get weather information and satellite 
maps because parts of our business are 
weather-sensitive. We integrate [the 
information] right into our system. We 
have a tie-in to automated news ser- 
vices, retrieving articles related to our 
industry. We can cut-and-paste those 
into our word processor or e-mail. The 
OS/2 architecture is giving us benefits 
we hadn’t anticipated. Of course, just 
being able to do something else while a 
compile is running helps a lot.” 


OLD SKILLS, NEW TOOLS 

Questar decided that, although it was 
revamping its software and business, 
changing everything didn’t make sense. 
“We estimated it would have cost an 
additional half-million dollars in retrain- 
ing costs if we were to change from 
COBOL to C. Then you have to factor in 
the huge amount of additional time, 
personnel problems, and risk of using 
code from programmers not familiar 
with the language.” 

By 1992, Questar had the tools in 
place that allowed it to take advantage 
of its programmers’ comfort level with 
COBOL. One tool they used was the 
MicroFocus Workbench, an integrated 
development environment with several 
functions designed to help these 
migrations. For example, the Work- 
bench can automatically convert 
EBCDIC to ASCII as mainframe code is 
brought to the workstation. 

An important aspect of the change, 
however, was the greater productivity 
a consistent graphical user interface 
could bring the user. Questar wasn’t 
interested in just bringing batch code 
to the workstation. But learning the 
Presentation Manager API and COBOL 
bindings sufficiently to produce high- 
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quality code would have taken 
more time and training than 
i Questar wanted to undertake. 
Another MicroFocus tool solved 
the problem. 

“We use Dialog/2 to develop 
all of the GUI front ends,” 
Edwards says. “We evaluated 
[Kasework’s] KASE:PM § for 
COBOL but didn’t see a reason to 
bring in another vendor. Dialog 
lets us paint screens with the user 
sitting right beside us. When the 
user is happy with the layout, 
Dialog generates a ‘screen set,’ 
which we compile into our pro- 
grams. Acceptance of the new 
software has been high because 
the users helped design it. They 
can see what they’re getting in 
advance, rather than talking 
about it, waiting five or six 
months, and having something 
thrown at them. 

“We've worked with some 
CASE tools that had horrible learn- 
ing curves, but this one was pretty 
quick. We had mainframe COBOL 
programmers producing GUI front- 
ends within a week. The program- 
mers took to the change really well. 
There were people who had been on 
mainframes for a long time who 
had a little trouble. We had some 
people who do outside program- 
ming and use MicroFocus COBOL 
on the PC, so we had a head start.” 

However, they aren’t integrated 
with the Workplace Shell because of 
the dependence upon Dialog /2. 
MicroFocus hasn’‘t included support 
for features such as notebooks and 
drag-and-drop, and Questar has 
decided to wait rather than plunge 
into OS/2’s API. Still, the combina- 
tion of better tools and the move to 
a different development methodol- 
ogy brought significant dividends. 

For example, Edwards esti- 
mates that the move to a consis- 
tent GUI interface has cut training 
costs in half. “The commonality 
and consistency of [Presentation 
Manager] makes it easier to train 
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users on the system. We can move 
people from job to job, and they 
can pick up the new computer 
programs easily. We credit the 
improved user interface with the 
fact that payments are now 
posted 24 hours earlier.” 

This wasn’t entirely due to 





Figure 2. Both business and software benefit from re-engineering 
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sticking with the Common User 
Access (CUA) standard. When 
queried if Questar’s programs 
conformed to the CUA specifica- 
tion, Edwards asks with a laugh, 
“Which one? We started off trying 
to adopt CUA, but we strayed a 
bit.” 











MAINFRAME AS FILE SERVER 

The old, flat file structure was a 
large part of the maintenance dif- 
ficulties because it didn’t offer 
much flexibility. Questar felt it 
could salvage its knowledge of 
CICS but needed to move to DB2 
databases. 

“We wanted to set up a coop- 
erative link between CICS/MVS 
and the workstation,” Edwards 
says. “One of the reasons we 
selected OS/2 was the ease with 
which CICS/OS2 could be linked 
with the mainframe. We came up 
with a strategy to [use] intelligent 
workstations [and] the mainframe 
as a file server. The PCs are 
Compaq 486 workstations that 
access a seven gigabyte DB2 rela- 
tional database on the host.” 

Currently, they have approxi- 


mately 700 PCs on 26 NetWare 
LANs connected to the Amdahl 
mainframe via a WAN. Managing 
the development and distribution 
of software across an environ- 
ment like this can be a headache. 
Questar uses IBM’s Netview 
Distribution Manager to handle 
this and reports success. 


MEASURING THE BENEFITS 

“We have moved to small, inde- 
pendent development teams,” 
says Edwards. “Having each 
piece small enough to complete in 
60 to 90 days has helped them see 
faster results. That helps morale. 
Programs are coming in ahead of 
schedule and under budget. 
Development time has been 
reduced dramatically. What typi- 
cally would have taken 600 to 700 


developer-days is now down to 
200. That lets us be more respon- 
sive as things change. For ex- 
ample, we have just decided to 
build systems for natural gas 
vehicles. We can have it com- 
pletely implemented in three to 
six months. 

“The [Presentation Manager] 
code is easier to maintain than the 
mainframe code. Plus, the change 
in development methodology cut 
down on maintenance. We’re 
finding fewer fixes—partially 
because the user is helping with 
the design and partially because 
the quality of the tools allows us 
to build things with fewer bugs.” 

Edwards describes the four 
keys to Questar’s success as new 
methodology, new tools, new 
team concept (with greater auton- 
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*} omy), and a new management 


| strategy. In fact, Questar was 
| nominated for an Ultra Award— 
an honor bestowed on utility 
companies demonstrating signifi- 
cant technical innovation. Ed- 
wards was recently asked to dis- 
cuss Questar’s move to OS/2 ata 
customer information system con- 
ference sponsored by Price 
Waterhouse in Orlando, Fla. 

“There was a lot of interest,” 
Edwards says. “There are around 
20 utilities [companies] that 
would like to come visit us and 
see what we're doing. A division 
of Questar is considering starting 
a consulting service.” 


MORE WORK, 

BUT FASTER RESULTS 

The dramatic decrease in devel- 
opment time occurs even though 
Questar’s technique demands 
more development effort. “We 
have made a commitment to keep 
the data in one place,” Edwards 
says. “One of the advantages of 
OS/2 is that it allowed us to write 
some behind-the-scenes code to 
pass information between 3270 
sessions and our OS/2 programs. 
Migrating small pieces has 
required us to build bridges 
between the pieces of data on the 
workstation and the pieces on the 
host. We still think that is better 
than having duplicate informa- 
tion. As we implement new 
pieces, we add new bridges and 
tear down some that are no 
longer needed. That is one of the 
hardest parts.” 


EASIER TRAINING 

AND SUPPORT, TOO 

Questar has 18 offices running 
OS/2 workstations. Training and 
supporting users meant traveling 
to remote offices for tasks that 
required visual access to the user’s 
computer. IBM’s Distributed 
Console Access Facility/2 made a 
significant difference in the num- 
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Figure 3. Host-based data is tightly coupled with the workstation 
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Figure 4. Dramatically faster order processing linked with mobile terminals 


ber of trips required and the dura- 
tion of phone calls needed for 
troubleshooting. 

“From 500 miles away, I can 
bring up a view of [a remote] sys- 
tem’s display,” Edwards says. “In 
fact, 1 can bring up more than one 
person’s screen at the same time 
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in different windows. This lets 
[me] set up a conference call and 
monitor their system.” 


EXTENDED CONNECTIVITY 

Questar has extended connectiv- 
ity beyond its WAN. The com- 
pany has a number of field per- 


sonnel handling distribution of 
natural gas. The information in 
Questar’s customer information 
system is accessible from 
the field via 135 mobile data 
terminals. 

In fact, the mobile data termi- 
nals are processing over 8,000 
transactions per day and have 
allowed Questar to reduce its dis- 
patching personnel, saving about 
$100,000 per year. 

The mobile data terminals are 
a key reason why Questar cannot 
afford any downtime. They access 
the customer information systems 
24 hours a day. This enhanced con- 
nectivity is also enabling better 
workload forecasting and schedul- 
ing of service orders. 


THE MOVE CONTINUES 

Questar is finding several new 
possibilities that the OS/2 work- 
stations offer. For example, the 
engineering department is using 
an Intergraph computer mapping 
system. Questar is now integrating 
that into the Customer Information 
System, allowing access to over 
5,000 maps. 

Questar is taking advantage of 
Win-OS/2 functions as well, using 
Microsoft PowerPoint and Excel 
and WordPerfect for Windows. 
Questar is also evaluating Pioneer 
Software’s Q+E query tool as a 
way of providing easy access to its 
database. To Edwards, this flexibil- 
ity is key. 

“We're strongly committed to 
OS/2, but that doesn’t mean we 
can’t run Windows applications on 
it. OS/2 is our lifesaver, allowing 
us to migrate and run the old and 
new at the same time.” 


Brian Proffit was part of IBM Corp.'s author of two books, 0S/2 Application 
OS/2 development team before leaving Development Tools and OS/2 Inside and 
to become director of PC Week Out. Proffit is a contributing editor for 
Corporate Labs, Proffit is currently presi OS/2 Magazine and has written for PC 
dent of Visionary Research, an indepen- Week, Dr. Dobb's Journal, and 
dent consulting firm. He also is the Programmer's Paradise. 





RemoteVision MultiPort Servers. 
The Proven Solution For Remote 
Token Ring Networking. 








To Token Ring’ 
Notebook 
Ethemet LANs 370 ! | 











= 


IBM LAN Server/ | : Ta 
Datal Me 3 Bridge 
|_| ae 


ey Token Ring = 


| 


RAV Remote 









= —— 


— RemoteVision 
NY 
=n , ae 
= ——— > 
Netware Server ie) —— = = 
Ms ona Lai 40 
SQL Server Rs/e000, “5400 
SUN 
= Extend LANs transparently over @ Connect to remote offices with LAN-to-LAN 
asynchronous modems to remote dial-up networking. 
workstations and workgroups. mw Add remote connectivity services using 


@ Run DOS, Windows’? & OS/2™ apps written existing LAN machines. 

to multiple protocol stacks on remote nodes.  m Access remote PC servers and hosts without 
w Operate remote computers as full-function additional host gateways. 

LAN nodes. mw Up to 64 ports on a non-dedicated server 


RemoteVision makes it easy and affordable for DOS, Windows and 
OS/2 users in remote locations to connect to Token Ring or other LANs 
using dial-up modems. Response time remains fast, applications don’t 
need changing, and users won't need retraining. So you can turn your 

remote machines into full-function workstations. With RemoteVision. 
To immediately find out more, or to take advantage of our “Try Now, 
Pay Later” 30-day money-back guaranteed trial offer, call today. 






ken 
Technology, inc. 


1265 Montecito Ave., Ste. 101, Mountain View, CA 94043 
Tel: (415) 965-8607, Fax info: (415) 965-8607, (then press 2) 
CompuServe 71612, 1253. Trademarks are from their respective companies. ©1994 Token Technology, Inc, 001-1 


Circle Reader Service Number 8 


JULY/AUGUST 1994 17 











| g 
A Special Report | 1) imo Nyy Th dae 





ULES? 


oy i 
Ne hottest REXX 
tips at your service 


from the 










- publishers of 








| OS 2 Developer! (eyes Co 


P a 
He rOtotypj 





H 








ng Dat 
; Applications tee X 
| Extending REXx 
a % ) | \ Deby j 
. gin 7 
: % Bi . y J REXX Applications 
\ 
a \Y y ’ 





ited. Orde, ny 








t service, 








“ach copy is only $9. 
Pl pase add $2.50 for shipping and handling. \ 
Z| My y Mail: Rexx Report 


heck i is enclosed 


yi ’ S!E \ ea | 
95 in the US or $10.95 im, Canada. 











 Chafge my credit card: J Visa \[Q MasterCard J American Express \ | P.O. Box 7046 = 
, . | San Franciseo =o 
ee é =. il CA 94120 
Name \ “a 
Signature Dat 4) Phone: 1-800-444-4881 





4 AY | Fax: (415) 905-4967 
Send then df 


| 





gg” 


heune Vie _ «i 4 
Address — _ ai 


City 





Postal Code 





Don’t even think about using a 






=. fold .bs4 


Use the POET Object Database for C+ + 


C++ and class libraries have made the GUI development much 
easier. After all, it is only logical that more and more developers 
think in objects. But object orientation shouldn't end at the user 
interface programming level. 


The Problem: Without POET, aC++ programmer must use flat 
files or a RDBMS to store objects. He has to write code to over- 
come the mismatch between the application and the database 
model. This leads to design restrictions, performance penalties and 
more code to write and maintain. 


The Solution: POET operates at the object level, it speeds up the 
development process and provides greater performance. Further- 
more, the developer can simply take the object-oriented applica- 
tion design in C+ + and map it 1 to | into the database. Without 


any compromise at all! 


, ee sl ae o- - a r ft ae (aa 2, A 
io ae A a : 


ee et es 7 f s 


Relational Database System ! 


oe - 


ae ee 2 










Storing Objects As Objects Break Objects 
inte Tables 








C++ Integration Total Poor 


At Object Level Must Write Code 
Full featured 


database: 

POET provides 
complete support 
for Encapsulation, Inheritance, Polymorphism and Containers as 








Increased Reduced 
| Complex Object Excellent Poor 





well as queries, object locking, and transaction handling . 


True cross platform support: Complete interoperability makes 
the development of network enabled applications a breeze. POET 
supports Windows 3.1, Windows NT, Win32s, Windows for 
Workgroups, Novell Netware (NLM), SUN, AIX, HP-UX, SGI, 
SCO, Macintosh, Power Macintosh, OS/2 and NeXTStep. 


Call 1-800-950-8845 





POET Software Corporation, 4633 Old lronsides Dr, Suite 110, Santa Clara, CA 95054, Tel: (408) 970-4640 Fax: (408) 970-4630 
United Kingdom (Silicon River) +44 81-316-7777, Germany (POET Software) +49 40-60-99-00, Australia (Micnoway) +61-3-580-1333, France (LCI) +33-1-34-65-7777 
Netherlands (Protools Software) +31 20 645 5023, Sweden (Duke Systems) +46 8 703 2781 


Circle Reader Service Number 9 





Feeling a little Shell-shocked after last issue? This issue's Programming Insider finishes up in getting you 
on your way to writing effective Workplace Shell-exploitative code. By DAVID REICH 


More InSOMnhnia and 
Workplace Shell Programming 





David Reich 


leeping better since last issue? 
S Hopefully the Programming In- 

sider column in OS/2 Developer's 
May/June 1994 issue helped you under- 
stand more about how OS/2’s Workplace 
Shell fits in with OS/2 and running appli- 
cations. In any event, this column takes 
that basic program a step further. 

When I finish with these descriptions, 
you'll have an object that knows its type, 
its association types, and its icon. Also, 
the object will start the appropriate print- 
ing function when it is dropped on a 
printer object. You don’t have to code all 
the function into the object, such as hav- 
ing it open, load, and print a data file. The 
object inherits some behaviors from the 
parent class, which I detailed last time. 

In the last column, you saw what 
Workplace Shell objects can do and how 


you should use them, such as not writ- 


ing an application as an object, but writ- 
ing the object to represent the data to be 
manipulated by application programs. | 
also covered how the Workplace Shell 
fits into the OS/2 system in a large, 
complex, integrated application that 
was written using SOM. 

You read about the basics of SOM 
and the SOM compilers and emitters, 
and how you derive everything from 
the .CSC file initially. From there, we 
took a trip into a small .CSC file that did 


little but show how the files interrelate 
and provide an object to install and try 
out. I provided the MAKE file and a small 
piece of code that shows how to install 
an object. 


THE CODE 

Figure 1 contains the complete .CSC file 
for this object. For those of you who 
missed my last column, I will review the 
whole .CSC file and discuss the change 
from last time, which is the addition of 
the methods that are overridden. 

After that, we'll take a look at the .C 
file shown in Figure 2. If you coded the 
example from the last installment and 
ran MAKE on it, you noticed that the .C file 
is generated for you by the SOM emit- 
ters. However, it looks empty, much like 
a window procedure that does nothing 
but call WinDefWindowProc for every mes- 
sage. In the .C file here, | added some of 
the filling. I will take you through the .C 
file function (or method) by function, 
describing what each does. 

Then, you'll be ready to hack at your 
own objects and see what Workplace 
Shell can do for you. 


THE .CSC FILE 

The .CSC file is where it all begins. This 
file is the primary input to the SOM 
emitters. Depending on the SOM emit- 
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ter options you choose, many files are 
output. The most important output files 
are the C, H, and DEF files that, at the very 
least, are needed to build the DLL that 
will be the class. 

Last time, the .CSC file contained 
only enough to define the class and 
show one example of a method to 
demonstrate what the .C file will look 
like. Now, the .CSC file in Figure 1 has all 
the method overrides to perform the 
basic level of work for any object. 

At the beginning of the file is the 
#include statement for the parent class, in 
this case, WPDataFile. Following that is the 
class definition section with the class 
name, class hierarchy, and stems for the 
emitters (which will become apparent as 
we examine the .C file). 

The formal parent declaration and 
the passthru section follow those sec- 
tions. The passthru section is used to tell 
the emitters to pass the section straight 
through to the .H or .IH file (as specified 
in the passthru section declaration). 

The other sections of the .CSC file 
define the instance data for the object (in 
this example, there is no need for 
instance data) and the methods. The 
methods section defines methods intro- 
duced by this object class, along with 
the methods the class overrides. 

For this example, there are no meth- 
ods that are introduced. You will notice, 
however, that there are two functions in 
the .C file that are not method overrides. 
Since the functions are not exported as 
methods, no other Workplace Shell 
object can invoke them. For this reason, 
they are private functions to the class. 

The overrides are listed with 
instance method overrides first; class 
method overrides follow. Also note that 
there is a special #define in the .C file 
delineating the separation of instance 
and class methods. Since any new meth- 
ods in the .CSC file will cause the .C file 
to be appended to when the SOM emit- 





ters are rerun, you must move the decla- 
rations for new instance methods above 
this #define. Otherwise, your class will 
not function correctly. 


THE .C FILE 

The .C file appears in Figure 2. We'll 
look at the file function by function (or, 
more precisely, method call by method 
call). Before we get into the .C file, I'll 
recap what this object does. 

The object is part of a mythical 
word processing package. The object 
class has a name and an icon. When a 
new instance of the class is created, it is 
associated with the executable pro- 
gram; when it is dragged over and 
dropped on a printer object, it will 
invoke the print code, passing it a flag 
to indicate not to show anything but to 
start up in “subset” mode to print the 
document. In addition, this word-pro- 
cessing document object class imple- 
ments style sheets. There are several 
ways this can be done, and I include 
one in this example. 


LET'S SEE WHAT THIS .C FILE IS AND DOES 
First is the section for defines, includes, 
and various pragmas. Don’t be afraid of 
these statements, although you may not 
ordinarily use them. The SOM emitters 
put most of them in there. The first few 
lines should look familiar. They are the 
define you set up in the .CSC file and 
some basic Presentation Manager 
includes. Then there is a function decla- 
ration that is internal to our class: 
SetTypeEA. 

Next is a set of lines, added by the 
SOM emitters, that suspend the output 
of compiler warnings and include the 
.IH file. The reason for the suspension of 
warnings is that the prototypes in the 
.IH file can cause compiler warnings. Be 
aware that the suspension of these 
warnings can mask real warnings in 
your source, so you may want to run the 
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file through the compiler once 
without warnings suspended to 
see that you are not hiding any- 
thing that may be a problem later. 





INSTANCE METHODS 

First are the instance methods. 
These are the methods that the 
instances of the class respond to, as 
opposed to the class methods that 
the class responds to. 


wpPrintb ject 

The wpPrint0bject method is 
invoked on an object whenever it 
is dropped on a printer object. The 
default, or parent class’s behavior 
for wpPrintObject, is to put up a dia- 
log box that asks the user if the 
data file (the parent class of our 
class) is a plain text file or a 
printer-specific formatted file. If, as 
in our word processor’s case, the 
file is neither, allowing the parent 
class’s method to handle it will not 
enable drag-and-drop printing. We 
need a different approach. 

If the data file format you use 
is neither plain ASCII nor printer- 
specific, and you want drag-and- 
drop printing, you will need to do 
some work. That work, however, is 
not very complicated. As outlined 
in the comments of this sample 
object .C file, you will need to call 
wpQueryRealName against the object to 
get the real file name the object 
represents. Then you will invoke 
the printing code of the applica- 
tion, passing that file name and 
some flag indicating that the appli- 
cation should print the file, but not 
show itself, and terminate upon 
completion. 

One way to do this is to call 
DosExecPgm and invoke the applica- 
tion. Another way to accomplish 
this is dependent on the architec- 
ture of the application; but if you 
separate the printing code into a 
function or set of functions in a 
DLL, you can export the print 
interface from the DLL and call it © 4 
from your object directly. Figure 1. The new object's complete .CSC file (continued on page 24) 
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The method that uses 
DosExecPgm is the simpler of the two, 
' both architecturally and program- 
matically. In it, you just call 
DosExecPgm and pass the information 
that is required. However, the DLL 
method is slightly more compli- 
cated and requires more work. 

The reason I advocate the DLL 
method instead of the DosExecPgm 
method of printing is because the 
former is much faster and easier on 
system resources. You export your 
printing function from the DLL 
and code it so that you can pass a 
file name and flag to this exported 
function. Then, rather than starting 
up a whole new process with 
DosExecPgm, you will call the func- 
tion in the DLL. Here, either you 
need to spawn a thread to call the 
print function or write the print 
function so that it starts its own 
thread inside the DLL to do the 
printing. If you do not do this, you 
will tie up the shell’s thread doing 
your printing and, therefore, hold 
up processing in the shell. 

Once the print job is spooled, 
you can terminate the program or 
function and return to the object, 
where you execute a return that 
ends the method override. 





peep 

The wpSetup method is called when 
an object instance is created. You 
can view it as a WM_CREATE message 
in a window procedure. It lets you 
set up specific settings along with 
the object at creation time. In this 
example, I set the .TYPE extended 
attribute for the physical file. 

To set the .TYPE extended 
attribute, you only need to define 
what the physical file name is and 
what the .TYPE should be. You do 
the former by calling wpGetRealName 
against the object itself. Once that 
is complete, you call the object class’s 
class method for QueryInstanceType 
(mynO_wpclsQueryInstanceType), which, 
as you will see in a moment, is —— 
defined to return My Object Document. Figure 1. The new object's complete .CSC file (continued on page 25) 
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Figure 1. The new object's complete .CSC file (continued from page 24) 





Figure 2. Sample object's .C file (continued on page 26) 


The extended attribute is needed 
to enable the associations. This is 
so the associations work properly 
when using the shell functions 
natively and from the ASSOCTABLE in 
the program executable file. 

Now you have the file name 
and the value to be set in the 


extended attribute. SetTypeEA, the 
internal function defined at the 
bottom of the program, will 
accomplish this. 

The other two overridden 
instance methods, wpCreateAnother 
and wpCreateFromTemplate, are over- 
ridden. This is because you should 
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control that creation no matter 
what action the user takes to create 
a new document. 


rsstaineth 
The wpCreateAnother method is called 
when the user creates a new class 
instance by selecting “Create 
Another” from the context menu 
from another document object. 
When a user creates a new in- 
stance in this manner, you should 
have control over how the object is 
set up. 

Whenever a new document is 
created in my word processor’s 
world, I want to provide a dialog 
to the user, giving them a choice of 
style sheets. (You can do whatever 
initialization you like in here.) You 
can implement style sheets in any 
way you want. I recommend that 
you put up a file dialog, prompt- 
ing the user for a file for use as a 
style sheet. In this way, you pro- 
vide the flexibility of using any 
valid file as a style sheet; the user 
simply chooses it when creating a 
document through the Workplace 
Shell. You may also add a selection 
for no style sheet if you want. This 
is all up to you. The point is that 
you are performing some setup 
whenever the user creates a new 
instance. 

To easily provide this style 
sheet selection, write a function 
that performs it. You will likely 
need to call it from multiple places, 
given the variety of ways you can 
create a new object instance. 

PutUpStyleSheetDialog, a func- 
tion that contains DosBeeps for 
demonstration purposes, is cal- 
led inside the override to 
wpCreateAnother. However, this is 
done after a call to the parent 
method. This is so the parent 
method can actually create the 
instance. Then, our function takes 
over to put up the style sheet dia- 
log. Once that is complete, the 
method is complete and the 
return is executed. 





Figure 2. Sample object's .C file (continued on page 28) 
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Figure 2. Sample object's .C file (continued on page 29) 
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Figure 2. Sample object's .C file (continued on page 30) 
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Figure 2. Sample object's .C file (continued on page 31) 
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Figure 2. Sample object's .C file (continued on page 32) 
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Figure 2. Sample object's .C file (continued on page 34) 
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upCreateFromTemplate 

The vpCreateFromTemplate method is 
called when (as the name implies) 
the user creates a new class 
instance by dragging one out from 
a template. Here you need to do 
the same as you did with 
wpCreateAnother. First, the parent 
method is called to actually 
create the instance. And then 
PutUpStyleSheetDialog is called to 
set the style sheet. 

Of course, this entire style 
sheet business is optional. I added 
it to show you how you can call 
parent methods to provide the 
function of the parent class, while 
allowing you to override as much 
or as little of a parent method as 
you need (or just to make use of 
the parent’s method and add to it 
rather than replace it). 


CLASS METHODS 

Class methods, as opposed to 
instance methods, are responded 
to by the class, rather than by the 
instances of the class. These are 
methods that all instances of this 
specific class obey because the class 
is doing the responding. These are 
the class method overrides for this 
sample object class. These are the 
basic methods almost any object 
you write will need to override. 
You will also notice the lines: 


#undef SOM_CurrentClass 
#define SOM_CurrentClass SOMMeta 


before each class method. I alluded 
to this previously when I men- 
tioned the specific lines the SOM 
emitters put before the class meth- 
ods that are not around the 
instance methods. Because of these 
lines, do not put instance method 
overrides after the first class 
method override. When you add 
new instance method overrides to 
a .CSC file, the emitters will put the 
code at the end of the .C file. So, if 
you add new instance method 
overrides, be sure to move them 
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Figure 2. Sample object's .C file (continued from page 32) 


above the first class method over- 
ride before you compile. 


wpclsQueryTitle 

The wpclsQueryTitle method is 
called when an object wants to 
obtain the name or title of your 
class. This method is simple 
because it returns an ASCII string, 
which is the class name. 

I coded the title so it matched 
the instance type. In this way, and 
as you will see in the following 
override, I only needed to return 
the string that is the title (“My 
Document Object”) in the override 
for wpclsQueryInstanceType. Now in 
the override for wpclsQueryTitle, the 
title can be returned by invoking 
wpclsQueryInstanceType on the object 
itself (mynO_wpclsQueryInstanceType). 


vpclsQueryInstanceType 
The wpclsQueryInstanceType method 
is called when an object wants to 
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know the type of object this is. As 
explained previously, the type is My 
Document Object, which is what is 
being set in the .TYPE extended 
attribute and is the title of 
the class. To respond to a 
wpclsQueryInstanceType call, you need 
to return only the text string. The 
string must be the same as the title 
field of an ASSOCTABLE. entry for the 
executable file. This linkage is how 
the shell links the .EXE and the ob- 
ject in its internal tables. 


The wpclsQueryInstanceFilter meth- 
od is invoked when an object 
wants to know the file system fil- 
ter for the file types for this type 
of object. This method, like the 
previous method override, helps 
the Shell map the executable file 
to the Shell’s representation of the 
data file (object). In this case, the 
mapping is for the file name 


extension or filter. 

In the ASSOCTABLE statement in 
the resource file for the executable 
program, you specify not only the 
type name but also a file name 
extension or set of file name exten- 
sions. In the override for 
wpclsQueryInstanceFilter, you return 
the text string that is the file name 
extension filter (in this case, *.MYN). 


PRIVATE FUNCTIONS 

The private functions are only 
callable by the method overrides 
for this class. These are internal 
functions of the DLL; they will be 
specific to your class and cannot be 
called by anyone but you. 


SetTypeEA 

This function sets the .TYPE ex- 
tended attribute for the file name 
passed to it. 


PutlpStyleSheetDlg 

Although this function does noth- 
ing but play a tune, its purpose is 
to perform the initialization you 
want during the initialization of a 
new instance of the object class. 


TYING IT TOGETHER 
Some of what I have covered in 
this column may not seem imme- 
diately obvious. You will under- 
stand it gradually as you work 
with Workplace Shell code. 

When you look at this object 
as an entity, first notice that any 


object entity has several interfaces 
to the Shell. For example, you can 
“link” applications to objects 
using several mechanisms. The 
first is the ASSOCTABLE in the exe- 
cutable. When the executable pro- 
gram is first awakened by the 
Shell, the ASSOCTABLE is read and 
associations are built. These asso- 
ciations hook the executable pro- 
gram with a file extension or filter 
and a type. 

These items (the filter and 
type) are two of the class methods 
that are overridden. The values 
returned in these overrides must 
match the values you place in the 
ASSOCTABLE. In this way, the Shell can 
access the object and invoke the 
executable no matter how the user 
accesses it (from the program 
object, from the document object, 
and so on). 

Also notice that there is no 
explicit code for the icon handling 
for the object class. If you use an 
ASSOCTABLE statement and specify 
an icon, the Shell will automati- 
cally pick up the icon from that; 
you do not need specific code in 
the object class definition for cus- 
tom icons. 

By using the small set of over- 
rides in wpSetup, wpclsQueryInstanceT ype, 
wpclsQueryInstanceFilter, and wpcls- 
QueryTitle, along with an ASSOCTABLE 
in the executable, you can provide 
the fundamental functions of a 
Workplace Shell object. 
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NOW IT’S UP TO YOU 

Once you have completed these 
functions, you can customize the 
class’s behaviors with overrides, 
such as wpPrint0bject and others. 

Carefully examine everything 
you do in your object class, be- 
cause the shell-defined classes are 
powerful and versatile. You will be 
tempted to concentrate on over- 
rides, but carefully examine the 
already-defined methods. There 
may be some function you can use 
rather than rewrite. Whenever pos- 
sible, use the class’s code rather 
than write it yourself. Refer to the 
example in wpCreateFromTemplate; 
notice that it calls the parent 
method to create the instance, 
then, before returning to the caller, 
performs the customization work. 
This concept can save you a lot of 
time and money. 

Use the sample object as a 
skeleton. If you combine it with 
the MAKE file from the my last col- 
umn, you'll be all set to write 
Workplace Shells objects. 


David Reich has been with the IBM OS/2 
development team since 1987. He has 
worked on many parts of the system, sup- 
ported customers and application develop- 
ers, and traveled the world giving seminars 
and teaching OS/2. He is the author of 
Designing OS/2 Applications, published by 
John Wiley and Sons. He can be reached on 
CompuServe at 76711,632 or via the Internet 
at speedracer@vnet.ibm.com. 
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everal years ago, the electronics 

industry was producing console 

_ stereos. These units were sold 

more like furniture than electronic 

devices. One large cabinet came com- 

plete with television, record player, 
speakers, and AM/FM radio. 

Consumer choices were limited. If 
you didn’t like the speakers, you had to 
live with them or buy a different model, 
but then maybe the record player 
wouldn’t be up to your standards. There 
was no way to mix and match the pieces 
of a system to match your needs, tastes, 
or budget. And if that wasn’t bad 
enough, when new technology arrived, 
you couldn’t just add it to the box. You 
had to scrap what you had and buy a 
complete new package. 

Today’s consumers would never tol- 
erate that. They are accustomed to pick- 
ing and choosing their compact disc 
players, speakers, tuners, VCRs, and 
video monitors to build their personal 
home entertainment systems. Shoppers 
have complete freedom to choose from a 
large number of products produced by 
different manufacturers using an ever- 
growing number of new technologies. 
They need not worry that their home 
system will be instantly obsolete 
because of a new product they might 
want to buy next year. They are safe in 





The emerging OpenDoc technology promises a cross-platform, language-independent, LAN-supporting 
standard for the exchange of compound documents among a variety of applications. We'll have more to 
say about OpenDoc and other OS/2 object programming topics in our September/October issue. For now. 
heres an introduction to get you started. By ROBERT L. TYCAST 


Component Software for the 
Masses: OpenDoc is Here 


assuming that the producers of con- 
sumer electronics will make sure that 
next year’s products will plug into the 
home system purchased today. 

This is ideal for both producers and 
consumers. Consumers have more flexi- 
bility and choices, and producers have a 
bigger market in which to sell their tech- 
nology. Upgrades to existing systems 
are easy, SO a modest advance in tech- 
nology can be parlayed into a successful 
moneymaker. New components can be 
marketed aggressively since consumers 
no longer wait until their console sys- 
tems “smoke” themselves into oblivion, 
requiring the consumers to throw them 
away and buy new ones. 

Today's software industry is in 
many ways comparable to the electron- 
ics industry of yesteryear. 

Applications are monolithic, contain- 
ing every possible function users might 
need (whether or not they really want 
them), locking them into a fixed way of 
working. New software technology 
requires upgrades or replacements. 
Finding a cooperative set of applications 
means buying into a suite of products, 
usually from a single vendor. There is no 
way to mix and match applications, no 
way to add new technology to an existing 
suite without a major update, and no easy 
way for the user to build a custom system. 
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The change in home electronics 
from console to component systems was 
revolutionary. The coming changes in 
the software industry ushering in com- 
ponent software will be no less so. And 
the first step in that revolution is called 
OpenDoc. 


OPEN SYSTEMS, OPEN STANDARDS 
OpenDoc is a collection of technologies 
donated to the industry by Apple, IBM, 
and WordPerfect, enabling the building 
of compound documents that can be 
exchanged, viewed, and edited between 
multiple platforms. 

Apple contributed the basic com- 
pound document technology of 
OpenDoc. Apple also created Bento, a 
technology that addresses the problems 
inherent in storing compound docu- 
ments, and Open Scripting Architecture 
(OSA), which makes interoperability 
between documents and parts of docu- 
ments a breeze. 

IBM donated its System Object 
Model (SOM) technology, which is a 
Common Object Request Broker Ar- 
chitecture (CORBA) compliant technol- 
ogy, enabling documents to be built as 
objects and distributed across a network. 
Finally, WordPerfect is contributing tech- 
nology that will enable OpenDoc docu- 
ments to work with Microsoft’s OLE2 
servers and containers, 

The technologies will be owned and 
distributed by a consortium, Com- 
ponent Integration Laboratories 
(CILabs). Modeled after the X Window 
System Consortium, ClLabs will distrib- 
ute the OpenDoc technologies, promote 
industry standards, and provide certifi- 
cation of OpenDoc compliance for soft- 
ware products, ensuring that shrink- 
wrapped packages work together from 
the start. 

In addition, Apple is providing a 
reference implementation of OpenDoc 
on its Macintosh platform. WordPerfect 





is creating one for MS-Windows, and 
IBM is writing OpenDoc implementa- 
tions for AIX and OS/2. 


PARTS AND PART HANDLERS 

Key to the compound document archi- 
tecture is the concept of a part. Parts are 
the individual components used to cre- 
ate a document. The most common one 
is the text part. It provides the ability to 
embed and edit text into a document. 
Other part-types may include graphical 
drawing parts; spreadsheet parts; multi- 
media parts, such as video and audio; 
spell-check parts; and so on. The list 
goes on and on because the OpenDoc 
architecture is designed to support all 
types of data—even data types not 
invented yet! 

How is this done? The basic pro- 
gramming unit is the part handler, and 
every supported data type has one. 
One nice thing about part handlers is 
that they need only concern them- 
selves with the bit of functionality that 
they provide. Developers of today’s 
monolithic applications must deal with 
every aspect of functionality provided. 
OpenDoc part writers, on the other 
hand, can concentrate on the area of 
specialty their part provides, uncon- 
cerned about other ancillary functions 
that users might want. After all, if 
users want to add other functions to 
the application later, they only have to 
add some part handlers. 


STORING THE DOCUMENT 
Once users have assembled documents 
with a diverse set of parts, they will 
want to store and exchange them with 
other users. Handling a document made 
up of multiple parts and data types 
would be less than trivial if it were not 
for OpenDoc’s Bento technology. 

Bento is designed to provide storage 
containers for multiple data types in an 
efficient and flexible way. As a docu- 
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' @ & ment is modified, Bento creates 


new drafts. This archiving of the 
document is very storage-efficient, 
since only the changes from the 
previous draft are stored. 

The Bento system provides an 
easy way to create links to other 
parts of a document or even out- 
side of the document. You can cre- 
ate a piece of a document once and 
link it to any number of other doc- 
uments, even when they are on 
diverse network nodes and plat- 
forms. This is important since 
today’s and tomorrow’s comput- 
ing environments are distributed, 
and the networks on which parts 
and documents will be found will 
most certainly be heterogeneous. 


SCRIPTING, EVENTS, 

AND RECORDABILITY 

Scripting, events, and recordabil- 

ity are all features supported by 

OSA-compliant parts. OSA 

defines the way in which docu- 

ments and parts communicate 
with each other, and OSA pro- 
vides a standard for part handlers 
that guarantees interoperability. 

This standard is called the event 

registry. It contains lists of com- 

mand verbs that applications use 
and the objects on which they 
operate. 

The registry gives precise def- 
initions on how to encode the 
verbs and objects. The verbs are 
further organized into suites 
according to the type of applica- 
tions that typically use them. 

Some examples of the standard 
suites are: 

*e Required: the base set of func- 
tions that all compliant parts 
will need to support 

¢ Core: defines file and edit func- 
tions and basic scripting 

¢ Text: defines basic text editing 
and formatting 

¢ Table: defines commands used 
for table editing and formatting. 

Once OSA support has been 
incorporated into a part, script- 
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¢ Provides ability to store 
diverse elements (datatypes) 
in one container 

® New datatypes can be 
added at any time 


* Highly portable 
implementation 

* Based on structured 
hierarchy: containers, 
objects, properties, 
value/types 


Bento: n 


. [Japanese] 1. A box lunch or 


picnic lunch. 2. A box or basket with 
multiple compartments, containing a 
collection of disparate elements arranged 
in an aesthetically pleasing manner. 


Figure 1. UpenDoc storage 


ability, recordability, alternate 
input, and other features become 
a reality. To get a sense of the 
power of OSA, here’s an example 
of how a typical OSA scripting 
component might read: 


tell application "My editor" 
select word 1 of paragraph 2 


ft 
om he 
| 
i] 
i] 
i 
| 
4 
i] 
=k 
i] 
4 
' 
= hee 
i] 
i] 
] 


' 
sebeeebkboewmeb ee eckea cake = 
i] i] t ! 

i i 





Figure 2. OpenDoc for OS/2 is on its way 
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cut selection 
end tell 


The OSA script closely resem- 
bles natural language. In fact, 
OSA makes it possible to create 
language-independent scripting 
components. Since the underlying 
mechanism is via OpenEvents and 
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After November 4, 1994, there will 
be two kinds of 0S/2 developers. 
Those who went to Colorad0S/2. 

And those who didn’t. 


Colorad0S/2 

October 30-November 4, 1994 
Cheyenne Mountain Conference Resort, 
Colorado Springs, CO 


ColoradOS /2. The definitive conference for 
OS /2 developers, in the shadow of Pikes Peak. 

Those who attend will get in on the very first 
in-depth analysis, discussion and demonstration 
of exciting new technologies like OpenDoc, 
WorkPlace OS and the first new object-oriented 
products from the Taligent Frameworks 
partnership. Plus the latest on SOM /DSOM 
and WPS. 

Those who attend will learn about object- 
oriented design directly from Grady Booch, the 
man who wrote the book on it. 

Those who attend will hear about the 
REXX language directly from its creator, IBM 
Fellow Mike Cowlishaw. They'll get the inside 
story directly from IBM Director of Object 
Technology Products Cliff Reeves. And they'll 
talk in-depth about internationalization 
and DBCS. 

And those who don't, won't. 

ColoradOS /2. Miss it, and you'll miss a lot. 
Make it, and you've got it made. 


Plan now to attend ColoradOS /2 

For reservations, call the Cheyenne Mountain 
Conference Resort at (800) 648-5717 or 

(719) 576-5003. For more information, call 
(800) 481-3389. or (719) 481-3389, 
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object specifiers, a script editor 
could translate the preceding 
script to: 


utilise l’application "My editor" 
selectionne mot 1 du paragraphe 2 
coupe selection 

fin de utilise 


with the simple click on a 
“Francais” radio button. (This 
example uses a format typical of 
the AppleScript language). 

Since applications can respond 
to OSAEvents, it’s easy to monitor 
event traffic and record it for later 
playback. Another advantage of 
factoring a part to be driven by 
OSAEvents is that any compo- 
nent—the user interface, the script 
language, voice or pen input—can 
generate an OSAEvent and drive 
the application. 


BRINGING IT ALL TOGETHER— 
SYSTEM OBJECT MODEL 

The SOM technology contributed 
by IBM sets the foundation for 
OpenDoc firmly on new object 
technology. SOM provides a 
CORBA-compliant way for parts to 
create objects that are platform- and 
language-independent and that can 
work in a distributed environment. 
This object “glue” is an essential 
ingredient to the CILabs strategy of 


supplying industry-standard object 
technology. 

The changeover to component 
software will be as profound a 
shift for users and software pro- 
ducers as the shift to third-gener- 
ation languages like FORTRAN, 
C, and PASCAL was in its day. A 
key part of IBM’s overall strategy 
is to exploit its software technol- 
ogy. OpenDoc builds on the lead 
that SOM represented in the 
objects world. It is an important 
step to taking OS/2 to new levels 
of functionality and flexibility. 


WHERE TO FIND OUT MORE 

This article has only touched the 
surface of OpenDoc technologies. 
Subsequent articles will go into 
more depth about how the archi- 
tecture fits together and how 
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developers actually write part han- 
dlers. Look for this series to con- 
tinue in the September/ October 
1994 issue of OS/2 Developer. 


Robert L. Tycast, /8M Entry Systems 
Division, Boca Raton, Fla., is an advisory 
programmer for the Advanced Pre- 
sentation Manager Development group. 
He joined 18M Corp. in 1989 from 
Digital Equipment Corp., where he 
served in a number of software develop- 
ment roles, including providing software 
support in the U.S., Latin America, and 
Europe. His project experience over the 
last 13 years includes X11, Al 
Technology (LISP and OPS5 support), 
and technical workstations (VMS and 
ULTRIX). Tycast has a 8.8. from 
Massachusetts Institute of Technology 
and has done graduate work in MIT's 
computer science department. 
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Preserving Your xBase Investment 

OnCmd can quickly convert your xBase applications to run directly in 
0S$/2's 32 bit Presentation Manager with few modifications. This 
eliminates development time and preserves your current xBase 
investment. Text applications are automatically converted to a 
native Presentation Manager application that is 

both multi-user and network capable. 

With simple code changes, you can add 

buttons, check boxes, and drop-down 

menus to give your application more 

functionality. 


PVE T lilt 
and Ready & 
Applications Development 

OnCmd's user-friendly develop- 

ment environment makes devel- 

oping new applications 

easy and efficient. The 

OnCmd screen painter 

brings point and click sim- 

plicity to screen designs, 

allowing you to develop the layouts you need, 

while preserving your control over application 

flow. Support for “event-driven” programming and 

the use of extensible Dynamic Link Libraries (DLL) offers even 
greater power to your database. 


Available 
and Ready § 
for IBM LAN 


Client/Server Ready 

OnCmd allows you to create a client server environment without the 
need for a dedicated server system. You can evolve into the world of 
client/server at your own speed and at a very low cost, allowing you to 
take advantage of the improved performance and application 

stability of client/server. 


OnCmd’ xBase for OS/2.... 


| il | 9 , © 
| A Winning Combination. 
OnCmd harnesses the power and the speed of 0S/2, enabling you to develop new applications or 
convert existing xBase applications, such as those developed in FoxPro, Clipper’, and dBase . 


Multi-User Networking 
OnCmd automatically enforces multi-user database integrity through 
the network with no code changes. File and record 
locking can be added to your application if higher 
level transaction integrity is required. You can 
add message passing to create co-operative 
or client/server relationships in your 
applications, including direct messaging to your 
"C" programs. 


A Performance Winner 
OnCmd is a performance winner! No windows 
emulation overhead. Disk requirements less 
than 1MB. Installation under 5 minutes. In 
addition, it typically indexes large databases 
twice as fast as the competition in half the 
disk space. For more benchmark details, 
call or email us. 
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ON-LINE DATA 

5 Hill Street, PO. Box 65 

Kitchener, Ontario Canada N2G 3X4 
Tel: (519) 579-3930 Fax: (519) 579-2130 
Compuserve: 70022,104 

Internet: oncmd@onlinedata.com 


* Prices are in US funds. 


Add $249 per 10 user blocks (Regular $498). 
Offer expires August 30/94. 


800-265-2455 | 


Product also available from: Indelible Blue Inc. 1-800-776-8284 (USA) 1-800-672-4255 (CDN. 


)} Programmer's Paradise 1-800-445-7899 Th t | 1-800-342- 
Online Data recognizes the following trademarks: FoxPro (Microsoft Corporation), dBase (Borland | g e Software Store (IBM) 1-800-342-6672 
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apoleon once said, “The pen is 
mightier than the sword,” but 
we Pen for OS/2 developers pre- 
fer, “The pen is mightier than the mouse.” 
The pen gives the user a much more intu- 
itive pointing device than the mouse. The 
pen also gives more information about its 
movement than the mouse can. 





PEN VS. MOUSE 

When you move a mouse, OS/2’s 
Presentation Manager handles the posi- 
tion of the pointer and knows when the 
mouse button is pressed or released, but 
any activity between the start and end 
points is ignored. Pen for OS/2, on the 
other hand, follows the pen’s movement 
across a touch-sensitive screen or digi- 
tizer and keeps all the point locations in 
a buffer. The collection of points 
between the position where the pen first 
touches the surface and the position 
where it is lifted up is called a stroke. 


INKING 

Pen for OS/2 provides messages and 
functions for a user application to 
process pen movement and produce the 
ink, which is the visible trail of the pen 
moving across the screen. Users can do 
their own inking of pen movement if 
they want a specific color or width of 
the ink or let Pen for OS/2 ink in the 





In this article, we'll show you how to use the pen as an input device, and even make it talk back to you! 
By VERA DULANEY and KEVIN LEE 


The Talking Pen: Coding a 
Pen/ Audio Application 


default color, Also, users can collect and 
manage pen movement or let Pen for 
OS/2 build a stroke buffer that stores all 
pen positions. When the buffer is built 
by Pen for OS/2, it is built in real time, 
and users are notified of its availability. 
If users want their own format of stroke 
buffer or do not need the data in the 
stroke buffer, the buffer is not built by 
Pen for OS/2. 


UNLIKE THE SPACE SHUTTLE, 
TOUCHDOWN COMES BEFORE LIFTOFF! 
There are four messages used to process 
a stroke: 


WM_TOUCHDOWN =© Makes contact with surface 
WM_UTFTOFF Breaks contact with surface 
WM_MOUSEMOVE Moves pen 


WM_SENSOR_MOVE Moves pen. 


All pointing device messages are sent to 
the application; Pen for OS/2 treats pen 
messages as mouse messages. The 
WM_TOUCHDOWN message is sent first to the 
window under the point of contact. There 
are three types of return codes; the delay 
between the touch-down point and the 
mouse-button-down event message, an 
option to override the default inking’s 
color and width, and options to receive 
coordinate data at full bandwidth, which 
sets the hardware sampling rate. 
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The application must call 
WinSetCapture function while the WH_TOUCH- 
DOWN message is being processed. There 
are several ways to handle inking and 
the stroke buffer, described in the Pen for 
OS/2 Programming Guide. 

Pen movement messages are sent to 
the application while the pen is in con- 
tact with the surface. Depending on the 
return code of WM_TOUCHDOWN, the WM_SEN- 
SOR_MOVE or WM_MOUSEMOVE message will be 
sent. The application can ink the stroke 
or perform other operations, such as 
erasing, as the messages are received at 
different surface locations. 

The WM_LIFTOFF message is sent to the 
application at the end of the stroke. Call 
WinSetCapture with NULLHANDLE to release the 
pointing device message capture. If 
TDN_NO_STROKE is returned to the WM_TOUCHDOWN 
message, the application can access the 
stroke buffer through the WrtQueryStrokeData 
function. To retrieve the data, the applica- 
tion must first query the size of the buffer 
to allocate sufficient memory to store it. 
Stroke data can be provided in either 
screen coordinate or window coordinate 
format. The application can replay 
retrieved stroke data later on the screen. 

If TON_INFINITE_PAUSE is returned to the 
WM_TOUCHDOWN message, Pen for OS/2 does 
the inking of the stroke and provides a 
stroke buffer. As points are entered into the 
stroke buffer, they are connected to the 
previous points and displayed on the 
screen to give the appearance of ink flow- 
ing from the point of the pointing device. 
The inking is done in such a way as to not 
interfere with the underlying graphical 
data. At the end of the stroke, the WM_LIFTOFF 
message will be sent to the application and 
a stroke buffer is available. The de-inking 
of the stroke will be done upon return 
from the WM_LIFTOFF message. 

Due to the high rate of movement 
messages determined by the hardware 
sample rate, each message must be 
processed in a short period of time. If 
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the application falls behind, it will still 
receive all the messages, but the process- 
ing of the points will appear slow com- 
pared to the pen movement. 

Pen for OS/2 currently limits the size 
of the stroke buffer to 1,000 points or 10 
seconds of activity. It checks each stroke; 
if it recognizes one as a predefined ges- 
ture, it executes an appropriate com- 
mand. But the stroke can be used in other 
ways, such as signature verification. Pen 
for OS/2 records not only the signature 
but also the relative speed of writing each 
letter in the name and even the timing of 
dotting the Is and crossing the Ts. 

Our example combines the use of pen 
and multimedia to save a pen stroke and 
audio response in a Presentation Manager 
window. We used the audio recording and 
playback feature of MMPM/2, the IBM 
multimedia system. This sample program 
(MMINK) is available in the current Pen for 
OS/2 Toolkit, on the Developer Con- 
nection CD-ROM. The voice attachment 
dialog box provides buttons to start 
recording, stop recording, and play back 
the recorded audio. While the program is 
recording the audio, it saves the stroke 
data through the WM_STROKE message. The 
key point is to store the stroke and audio 
data with an internal timer so they can be 
played back synchronously. 

This is an example of an application 
that could use the synchronous annota- 
tion of voice and ink data on a document. 
Suppose an office manager is reading a 
document displayed as a bitmap ina 
Presentation Manager window and wants 
to modify the document. The manager 
can use a pen to circle an area to modify 
and record voice instructions at the same 
time. Later, the secretary can replay the 
ink and audio annotation on the docu- 
ment and modify it. If the manager’s and 
secretary's computers are connected by a 
network, all document, stroke, and voice 
data can be sent between them directly by 
electronic mail. 
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Figure 1. Sample program for handling pen strokes (continued on page 46) 
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is Here Today! 
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WORK MORE PRODUCTIVELY — Direct on-screen input 
means quicker and easier interaction with your computer. 
| PenDirectis the most advanced light pen solution available 
today for 0S/2. 


/ WORK FASTER — PenDirect for 0S/2 is very fast. Click, point, 
drag and draw with greater speed and precision than you can 
get from any other pointing device, plus a light pen won't fight 
with you for desk space. And with PenDirect's easy-to-install hard- 
ware (ISA, MCA or optional external) and solid award-winning 
software, you'll be up and running in just minutes. 


| WORK SMARTER — PenDirect works great with all of your 

0S/2 software. Enhance graphics programs and bring desk- 
top conferencing to life. Effortlessly navigate large spread- 
sheets, and get real light pen support for your 32/0 apps. 
PenDirect fully supports all OS/2 2.x, Windows and DOS apps 
— at any screen resolution. Everything you need is included, 
no special monitor is required, and PenDirect lets you con- 
tinue to use your mouse. 


| WORK IN COMFORT — PenDirect's one-to-one cursor interac- 
tion means long-term ig use that's simple and effortless. 
The pen's precise and 3 
} quick input maximizes 
| cursor control to elimi- 
nate “mouse dyslexia.” 
You'll find your natural 
-hand/eye coordination 
| beats fumbling with an 
awkward mouse any 
day. Light pens also 
eliminate the tedious 
| wrist movements asso- 
ciated with mice that . | 
cause fatigue and re- filtg pen computing ftnetonaliy te desktop 
petitive strain injuries. 


or more information, call: 
WORK SAFER — PenDirect for 0S/2 comes from FTG 


anwar +, Data Systems, recognized as the world leader in | 


i light | 
ght pen technology for PCs. FTG sells reliable _aar_2 ; 
American-made products backed with the 114-995-3900 * FAX 714-995-3989 


best warranty in the industry, outstanding toll- 


For a free 30-day evaluation unit, 
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free customer support and an unconditional . 
= : DATA 8381 Katella Avenue 
no-risk, no-hassle evaluation/return policy. Fl FTG SY iforni 
37 day, With over 100,000 pens installed, FTG is your aod or papain 
Os aie safe choice and your best choice. 


Cc) 1994 FTG Data Systems. All rights re served. Screen shot courtesy of PenDirect is a trademark of FTG Data Systems. 08/2 is a trademark of International Business Machine 
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Figure 1. Sample program for handling pen strokes (continued on page 47) 
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Figure 1, Sample program for handling pen strokes (continued on page 48) 
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seesesnensnesensesnsnetonetenensnensnensesesnsnsnsssnensnenensees/ 
buflen = 0; 


pStrokeData = NULL; 


rc = WrtQueryStrokeData((PBYTE) pStrokeData, &buflen, hWnd, QSD_SCALE, 0, 0, 0); 


if (rc J) 'buflen) 
return (MRESULT) TRUE; 
ees HeeH oe eeeoEacooo Hoe eee eeeeeeeeanaannanes 
* Allocate memory for the stroke buffer. + 
FREER ESERIES SSAA RES AAA TES / 
pStrokeData = (PSTROKEDATA) malloc(buflen); 
4 ( '!pStrokeData ) 


return ( (MRESULT) TRUE ); 
ibinibenee ene e Le LTLLLLLLLE LOL TCT eet TT TTT Tee Tet eT Teer eee eT eT 
* Get the stroke data * 
FARBER ESOS OEE Oa IEE ECCS aaa en cabot / 


pStrokeData->cbStructSize = sizeof ( STROKEDATA ); 
if ( WrtQueryStrokeData ( (PBYTE) pStrokeData, 


Figure 1. Sample program for handling pen strokes (continued on page 49) 


MMINK.EXE | 


a OR 


The purpose gf 
familiarize yf 
OS/2. Sebetetian and interaction are 
provided to help you along the way. 


To continue, tap on “Malet 
button once. 


| Voice Attachment 


Duration: 2d Elapsed: 0 


Perea 


Vouume: 100 (aT 





Figure 2. Sample screen with corrections made by both ink data and voice annotation 


Figure 2 is an example of of 
what it would look like if the man- 
ager wanted to remove the Pen for 
OS/2 icon, change “Animation” to 
“Annotation,” and change the bold 
font of Forward to italic. 

As shown, the pen is capable of 
more functions than the mouse. If 
the stroke is recognized as a prede- 
fined gesture, Pen for OS/2 exe- 


be used for handwriting control, 


for applications that require a spe- 
cialized keyboard. Several applica- 
tions that take advantage of the pen 
functions are already in use; for 
example, parcel delivery systems. 
More applications will be available 
as more pen-based systems are 
developed. 


Vera Dulaney, /BM Persona! Systems 
Programming, Boca Raton, Fla., is man- 
ager of the MVP Pen and Speech Design 
and Development department. She has 
been a member of the OS/2 development 
organization. 


Kevin Lee, /BM Personal Systems 


Programming, Boca Raton, Fla., is a mem- 
ber of the MVP Pen and Speech Design 
and Development department. He joined 
IBM in 1983. Lee has worked on compiler 
development, transaction processing sys- 
tems, language theory, and OS/2 


cutes the command that is preas- 
signed to the gesture. The pen can 


which enables the Pen for OS/2 
user to input handwritten text. The 
text is recognized and converted to 
alphabetic and numeric characters. 
Pen for OS/2 displays virtual 
keyboards. This is useful particu- 
larly tor a keyboardless system or 
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&buflen, 





hwnd, 
QSD_SCALE, 

0, 

0, 

0)) 
return ( (MRESULT) LO_STROKE_PROCESSED ); 

SRE RAEI TRE ITAA IATA BE 

* Append the current stroke data to doubly linked list for later * 

* use. * 

Peeerererererrrrrrrrr rrr rrr Trt ttt tet tirtict tities ts sss ost tts 7 | 

/ EXAAERAAASAAELAA EEA AA EAKEKALHRASE ERE EREEE ERE ERE EEE EERE EEREREE EEE 

* Use existing structure entries for the stroke to hold the + 

* specific data of the current stroke, for ex., touch down time * 

* and lift off time. * 
PerereverTererrrrrretrert ttc ett c crt i iit oocr ores setae alot et) 
StrokeBufferQverrun = FALSE; 
return ( (MRESULT) LO_STROKE_PROCESSED ); 


Figure 1. Sample program for handling pen strokes (continued from page 48) 
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Restore, Migrate and Manage 
Your Workplace Shell Desktop With ... 










6 ee ow 
<x < SS DeskMan/2™ is the first 


"l installed 05/2" 2) golden code, and DeskMan/2 saved me at least 4 hours 
and only tool designed to 


of tedious labor. | can't imagine being without it." 


manage the Workplace Shell™! David Bames - Senior Staff member - |BM's OS/2 Executive Briefing Center 
DeskMan/2 for OS/2 is unmatched in its ability to fully exploit (F) API & GUI for local & remote access Change multiple folders or icons all 
the power and versatility of OS/2! Managers can use its security @ CID enabled & LAD/2 supported at once -- just drag and drop 
features to protect access to windows or objects. Administrators Delete “undeletable” objects @ Full administrative contro! of all features 
can easily and quickly standardize a department’s desktops for Prevent the deletion of any object Restore, save, migrate any/all objects 
maximum job efficiency. Individual users can quickly and Query any object for settings Total management of Workplace Shell 
easily migrate icons, objects and desktops between office and Secure individual windows @® And much more... 
home machines. Or use DeskMan/2 to backup and completely Secure groups of windows @ Call DevTech for current infot 
restore a custom desktop. 

Deviech 


Incorporating the powerful VUEMan/2™ virtual desktop & 
window manager; the potent new WPS snapshot facility; and 
more, DeskMan/2 is packed with features! 


Development Technologies, Inc. 
Software Development & Technology Transfer 
308 Springwood Road, Forest Acres, SC 29206-2113 Voice: (603) 790-9230 Fax: (803) 738-0218 


© Copyright 104 Development Techaoiogies, inc. Allright: meserved. Deakidan, Deakidan? and VUEMany? are bademarics of Development Technologies, inc 
Workplace Shell i 4 trademark of Intemational Business Machines Comeoraion. (BM and 06/2 a regeriered trademarks of Intemational Business Machines Corporation 
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3209 Gresham Lake Road, Suite 135 Raleigh, NC 27615 
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Attention Mathematica users: 
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of your math programming is in 


THE MATHEMATICA JOURNAL 
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Designed for ease of use both by programmers and non- 
programmers 

Generate C and resource source files to automatically add 
context-sensitive help to applications 


Import wordprocessing files, including WordPerfect, to 
create on-line documents quickly and accurately 


Preview IPF file output without compiling 
» Create all hypertext links automatically 
Improved creation of hypergraphic links 


> Now available: Add voice and music to help and on-line 
documents with optional voice support module 


Create IPF tables from 1-2-3 and Excel spreadsheets 
Compatible with both Netware and LAN Server 
Includes complete on-line help 


Call or fax today for information about 
subscriptions and special issues: 
Phone orders: 415-905-2332 

Fax orders: 415-905-2233 


REACH 36,000+ 
ACTIVE, QUALIFIED 
OS/2 DEVELOPERS 
COST-EFFECTIVELY! 


CONTACT: KRISTIN MORGAN 
V/212.626-2275 F/212.869-0899 
email: kmorgan @ mfi.com 


x New - Modify on-line documents screen size, position 
* New - Multiple-language support 

lew - Footnote support ‘ : 
»* New - Footnote suppo Price: $150 


Perez Computing Services Orders and 
4725 Monte Vista Place Information 


Mount Vernon, WA 98273 (206)428-5025 | 


on compuserve at 
Ailconpany and product names are adem Tadernarks of Prot reapaceve 70410,2416 
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FAX for OS/2 
From the developers of FaxWorks OS/2 and PMfax — 


Client/Server API and Printer Driver Toolkits 
Support for LANs, up to 96 lines per CPU, 


Opt-Tech Sort/ Merge 


Use as a stand-alone utility or callas a x Subroutine: Many 
features including unlimited file size, multiple keys, record 


and all popular fax hardware 


Keller Group Inc. 
Voice: (612) 429-7273 Fax: (800) 329-3293 
CIS: 72120,3404 Fax: (612) 653-1987 


Faxworks is a trademark of SofNet, Inc. PMfax is a trademark of Keller Group 


selection, duplicate elimination, summing and more! 


Call for free brochure § Opt-TechData Processing 
P.O. Box 678 

Available for: Zephyr Cove, NV 89448 

OS/2 or Unix $249 Phone (702) 588-3737 
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TCP/IP for os/# 


Supports all released versions of OS/2 
including 32bit API for OS/2 2.0 and above 


IRMWARE SERVICES 


EDPT - Employee Development Planning and Tracking a low cost solution to fully 
automate Human Resource procedures (may be customized to meet your needs). 


E/R DIAGRAMMER - An inexpensive entry into CASE technology that remains 
methodology independent without losing the precision of binary cardinalities. 


iIRMWare specializes in custom business solutions and software development. 
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re REMOTE LAN. 
Ci NETWORKING 


RemoteVision extends LANs transparently over dial-up connections. 
RemoteVision provides access to a LAN from remote machines or 
remote LANs. Remote DOS, Windows, and OS/2 machines have a 
simulated network adapter. 

Communications to the LAN is provided by the RemoteVision Server 
and async modems. Most LAN protocols and applications work, includ- 
ing NetBIOS, Named Pipes, APPC, 802.2, TCP/IP, and IPX. CAII 
(415) 965-8607 and use option 2 for a free fax-back. 
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For the last year and a half, | have been working on a set of class libraries intended to provide a virtual 
operating system, network, GUI, and run-time support system for OS/2 applications. | have learned many 
things and hit many brick walls. Here, | share some juicy tidbits to aid your OS/2 development efforts. 
Although this article is ostensibly C++ oriented, it leans toward giving you insights into OS/2 that are 
necessary to develop a powerful class system. By DEAN RODDEY 


An Example OS/2 C++ 
Class Library System 





Dean Roddey 


ny such class library project is 
a compromise between sup- 


porting OS/2’s power and 
making it somewhat portable to other 
platforms. Although OS/2 catches 
much grief in the press, its problems 
are political, not technical. Sadly, a 
portable class system cannot make use 
of many Presentation Manager services 
because the Workplace Shell is so far 
ahead of the field at this time. Al- 
though my project covers kernel and 
GUI services, this article deals only 
with GUI issues. There are times, how- 
ever, when I must discuss kernel] ser- 
vices to fully cover the subject. 


THE BASICS 
The most basic issue for creating a class 
system over Presentation Manager is 
wrapping Presentation Manager win- 
dows into a class. If each window is an 
instantiation of a window object, there 
must be a way to link the window to the 
window object. There are two reasons 
for this. First, the window object must 
operate on the Presentation Manager 
window in response to calls to its meth- 
ods. Second, window events coming to 
the window must be mapped to win- 
dow class methods. 

The first issue is simple; the window 
object can store away a handle to the 


window. The other side of the equation 
is more difficult because window events 
arrive at the window without knowl- 
edge of the C++ language. The most 
common approach to this problem is to 
use the window's extra data to store a 
pointer to the window object. When a 
message comes in, the window proce- 
dure extracts the pointer to the window 
object and calls the correct methods for 
the event. 

There are a number things to watch 
out for. A window procedure cannot be 
a class method since all class methods 
must have an implied pointer to the 
object. But window procedures are 
called from Presentation Manager and 
must have the prescribed window pro- 
cedure format. The answer is to create a 
protected friend method that acts as a 
gateway into the window class. A friend 
procedure does not have an object 
pointer parameter, but it can call pro- 
tected class methods. Window messages 
come to the friend method, which 
extracts the window object from the 
window’s extra data and calls the real 
window procedure method. 

You should have only one main 
window procedure in the entire pro- 
gram so all messages will come 
through it. To achieve this, all classes 
that encapsulate existing Presentation 
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Manager windows should subclass the 
control using the window class’s friend 
method. Custom classes can use the 
friend method as their window proce- 
dure when they register their window 
class. This seems like a lot of effort and 
somewhat backward, since the whole 
point of Presentation Manager is to 
allow each window class to provide its 
own layer of window procedure, allow- 
ing most messages to fall through to the 
layer below. 

But C++ offers a much more pow- 
erful layering capability in its class sys- 
tem. Keep in mind that Presentation 
Manager’s window procedure system 
is a grand compromise intended to 
offer, to a degree, inheritance mecha- 
nisms to procedural languages. In 
doing so, the window pracedure sys- 
tem abandons strict type checking to 
achieve a pseudo run-time linkage sys- 
tem, similar to the C++ virtual method. 
C++ can provide all those layering 
capabilities and more while maintain- 
ing stricter type checking. 

To provide the layering system that 
will work with Presentation Manager, 
the basic window class should provide a 
number of virtual methods that corre- 
spond to the window events it wants the 
window objects to respond to. Also, it 
should store, as a data member, the 
address of the default window proce- 
dure that will be called if the derived 
window class does not want to handle 
an event method. 

For classes that encapsulate 
Presentation Manager windows, this 
would be the Presentation Manager con- 
trol’s window procedure. For custom 
classes, it should be the default 
Presentation Manager proc. Each event 
method should return a Boolean value 
that indicates whether or not it goes to 
the default proc. If the derived class han- 
dles the event, it returns TRUE. Then, the 
window procedure method will return 
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the correct “I handled it” value for that 
type of window event. If the derived 
class wants to let the event go to the 
default handler, it returns FALSE. It can 
either not override the event method (in 
which case the default version provided 
by the basic window class will return 
FALSE) or provide some processing and 
return FALSE to let the event go to the 
default handler. 

When a virtual method is called, it is 
vectored to the highest level class that 
has overridden it. This class can handle 
the event, call its parent’s version and 
provide more processing, or return FALSE 
to force the event to go to the default 
handler. This allows for the incremental 
improvement of functionality that C++ 
is so good at. But beware that we live in 
an imperfect world: sticky issues arise 
when you implement a cleanly layered 
system on top of a system that it cannot 
control totally. 


STICKY ISSUES 
There is a nasty side effect to this kind of 
system. Since the entire structure is 
based on the fact that all windows have 
a pointer to a window object, there is no 
easy way to support existing non-C++ 
code within this framework. If you cre- 
ate an non-C++ window as a child of 
one of your new objectified windows, it 
will almost certainly post or send mes- 
Sages to its parent or owner. This mes- 
sage will go to the central window pro- 
cedure, which will attempt to extract a 
pointer to the window object and call 
methods therein. At this point, your 
application will crash. Certain schemes 
could solve this problem, but they 
involve too much overhead and com- 
plexity, unless you are desperate. 
Another sticky issue involves WM_CRE- 
ATE messages. This is not an issue for the 
classes that encapsulate Presentation 
Manager controls because you will 
probably just subclass them. Because 
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subclassing cannot happen until 
the window is created, you will 
never see the WM_CREATE message. 
But there is a problem when you 
are dealing with custom window 
classes. If you add a virtual 
bCreate() method to your basic 
window class, you will discover a 


Supercharge 
B (1)! | 


Supercharge your REXX with 
the most complete set of REXX 
external functions available - 
Gammatech REXX SuperSet/2. 


With over 300 functions from 
seven DLLs, the Gammatech 
REXX SuperSet/2 will initiate File 
and System operations, issue 
Network commands, execute 
Video 1/0, manipulate Processes 
and Semaphores, regulate the 
Macrospace and perform Math 
calculations. 

Call us today at (405) 947-8080 
and you'll see what REXX can do 
with some extra power! 


quirk of C++: when you call a con- 


structor for a class that is high up 


the class hierarchy, the construc- 


tion actually starts at the bottom. 


This is necessary, since each class 


level needs to call its parent con- 
structor. Eventually, the call chain 
reaches the lowest level construc- 


! 


© Perform EXECIO functions 

® Manage LAN Server users by group or domain 

@ Perform LAN Server permission functions 

© Manipulate LAN Server files, sessions and shares 

© Interface with NetBIOS, TCP/IP and 
Communications Manager/2 

© Open, close, query and create semaphores 

® Start a thread 

© Destroy a process or thread 

© Copy, move or rename individual or mass files 

© Dump variable pools or Macrospace to a file 

© Load, drop or reorganize functions in 
Macrospace 

@ Perlorm logarithmic and trigonometric 
calculations 

@ Query hardware components 

© List current system environment variables 

e Write character and attribute strings 

© Obtain and set cursor type and screen mode 


SIS 


SofTouch Systems, Inc. 
Wt el 


1300 S Meridian, Suite 600, Oklahoma City, OK reali 
(405) 947-8080 Fax (405) 632-6537 


Gammatech, Inc. 1991-94 All Rights Reserved 





Circle Reader Service Number 29 


os/2 DEVELOPER 


tor, which completes its function 
and starts back upward. 

In my system, the actual call to 
WinCreateWindow() takes place at the 
lowest-level WINDOW class. So, when 
the WM_CREATE message arrives, the 
object is really a WINDOW object, and 
the virtual method will not reach 
the original calling class. This 
makes sense because that class has 
not initialized its members and 
would not be in a position to deal 
with the event. 

But this is not a big issue. The 
reason for the WM_CREATE message is 
to initialize the window state. But 
in our objectified system, the con- 
structor serves that purpose. So, 
have the window procedure 
method eat the WM_CREATE message. 


PRESENTATION SPACES 

The vast majority of Presentation 

Manager windows use cached pre- 

sentations spaces, meaning that 

they only exist for the length of 
time of the WM_PAINT message. This 
makes sense; keeping 100K of 
memory or more (the amount 
needed for a persistent presenta- 
tion space) for every cell ina 
spreadsheet doesn’t make sense 
when it is needed infrequently. 

Other windows use more complex 

presentation spaces that are persis- 

tent and use different coordinate 
systems. 

Here is a list of some potential 
problems with presentations spaces: 
e Persistent and cached presenta- 

tion spaces must be created and 
destroyed differently. Also, any 
invalidation of a SYNCPAINT win- 
dow during WM_PAINT processing 
will cause a recursive call to the 
WM_PAINT code. 

e Advanced applications often 
paint to a single window via 
multiple threads, each of which 
really needs its own presentation 
space. 

¢ Two mutually exclusive color 
schemes (indexed or RGB) may 
be used. 


* Some GUI resources are tied to 
the presentation space on which 
they were created and become 
useless when the presentation 
space is destroyed. 

¢ Each layer of the class system 
cannot assume the state of the 
presentation space that they are 
given to paint on. Nor can they 
modify it, unless that is the pur- 
pose of the method that is called. 

We dealt with the first two 
problems by creating a PAINTBRUSH 
class. This class’s constructor 
accepts a window object that it 
should operate on. It extracts the 
window handle and creates a pre- 
sentation space from it. This PAINT- 
BRUSH object then can be used to 
paint on the window. The PAINTBRUSH 
class provides methods for all 
desired graphics primitives. At first, 
we stored the presentation space in 
the window, but the recursive 
nature of painting and the occa- 
sional need to have multiple threads 
paint to the same window required 
a change to the architecture. 

Even so, this new system is a 
compromise: now we have two 
objects that are linked via a com- 
mon system resource. If the win- 
dow object is destroyed, any fur- 
ther access to the PAINTBRUSH object 
will cause errors. There is a pro- 
tected constructor available to the 
WINDOW class to handle the special 
case of WH_PAINT messages. And 
there is a third constructor that cre- 
ates a persistent presentation space 
and accepts extra parms for page 
units. A flag in the PAINTBRUSH object 
indicates the type of presentation 
space, so the destructor can clean it 
up appropriately. 

In my opinion, the second 
problem is insurmountable if you 
desire to create a consistent, plug- 
n-play environment. Therefore, we 
avoided the problem by using only 
RGB mode. This may be unaccept- 
able to many because of memory 
usage issues, but the Year of the 
True Color Card is not far away, 


and we are looking forward, not 
backward. 

We created an RGBCLR class that 
handles all the niceties of RGB 
color values. We provided a global 
set of named RGBCLR objects that 
correspond to the usual 16 colors, 
plus some special ones. We pro- 


Sinart-Lock 




















based on Smart-Cards 


itt —— 
a 


Smart-Lock is a security 
concept that controls the 
access to OS/2 systems by 
employing Smart-Card 
technology and a SOM- 
based restricted workplace 
shell. 


Smart-Lock configures the 
OS/2 desktop according to 
the information on the 
E2PROM chip. Features 
include user specific boot 
protection and diskette 
access, single logon to LAN 
and host as well as the 
possibility to encrypt data 
and faxes. 
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* a comprehensive security and configuration concept 
for host-connected OS/2 workstations 


featuring the Chip-Controlled OS/2 Desktop 


Distribution, installation and 





vide a CLRPAL class for those appli- 
cations that must use indexes. 
When converting RGBCLR objects to 
a form passable to GPI APIs, you 
can reduce overhead greatly by 
having the color component mem- 
bers in the same order as the 
Presentation Manager RGB values. 





Smart-Lock is CID enabled 
and allows easy installation 
and maintenance in large 

networks. 





support in the U.S.A. and 
Canada through: 


International, Inc. 


621 NW 53rd Street, Suite 240 
Boca Raton, FL 33487 USA 
4-800-45E-INTL or (407) 241-3428 
Fax: (407) 278-3919 





. @ ff Then, you can provide an implicit 
| conversion method that will refer- 
ence the first member and derefer- 
ence it as a long value. This allows 
RGBCLR objects to be passed directly 
to GPI APIs with no intervening 
conversion to a temp variable. 

The third problem is a problem 
primarily for logical font and 
bitmap IDs. Since fonts pose par- 
ticular problems, I will cover this 
third problem shortly. 

We dealt with the fourth prob- 
lem by creating a GRAPHICATTR class, 
whose constructor accepts a PAINT- 
BRUSH object and an attribute bun- 
dle identifier. Presentation Man- 
ager supports a number of 
attribute sets that can be saved and 
restored as a group. The GRAPHICATTR 
class saves a particular bundle and 
restores it when it is destroyed. 
This greatly simplifies the logic of 
the medium-level graphics output 
methods that perform lower-level 
operations on behalf of the caller. 
They simply create GRAPHICATTR 
objects to store the attributes they 
will modify. Any exit from the 
method destroys the object, restor- 
ing the caller’s attributes. Of 
course, this saving and restoring of 
attributes should be minimized 
because it has performance costs. 
Another possibility is to add the 
Presentation Manager attribute 
push and pop mechanism to the 
PAINTBRUSH class, but it would not 
have the same automatic cleanup 
mechanism as a separate object. 





FONTS 

Fonts are sticky; they usually are 
installed by the user, rather than 
built into the operating system. 
They have numerous parameters 
and a number of formats. 
Sometimes bugs are in the font 
files themselves. If you look at any 
commercial package (object ori- 
ented or otherwise) you can easily 
recognize that fonts can be compli- 
cated. Some packages don’t sup- : = 
port fonts at all, and others pro- Figure 1. Skeleton of the basic Window class (continued on page 57) 
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vide very limited support. On this 
issue, you may have to bite the 
bullet. If your applications require 
heavy font usage, and no class sys- 
tem is available that can provide 
that support on the desired plat- 
forms, you may have to back off 
some platforms or do a lot of per- 
platform coding. 





OUR APPROACH 

We abstract fonts very heavily due 
to their inherent cross-platform 
complexity and because there are 
many font problem areas just in 
Presentation Manager. We created 
a FONTINFO class that is just a front 
end to the FONTMETRICS structure of 
Presentation Manager. The appli- 
cation can request a linked list of 
FONTINFO objects that match a face 
name and a somewhat limited set 
of attributes. We tried to limit the 
attribute set to a reasonable subset 
that would be useful yet portable, 
but there will probably be prob- 
lems in the first port. Some attrib- 
utes may just have to be ignored 
on some platforms. 

Also, only a selected set of 
FONTMETRICS fields is accessible so 
that extremely Presentation Man- 
ager-centric font manipulations are 
not spread around the application. 

To use a font, you must create 
a logical font ID. As discussed pre- 
viously, when a presentation space 
is destroyed, the current font selec- 
tion is lost. Also, in subsequent 
platform ports, you cannot always 
foresee the associations between 
window state and fonts. 

For these reasons, and because 
there are only 254 font IDs avail- 
able per process in Presentation 
Manager, we decided to keep 
strict control over fonts, to the 
extent that we do not have a font 
class. Instead, the application finds 
FONTINFO objects that represent its 
desired fonts and asks a PAINTBRUSH 
object to create a font of that type. 
When it wants to the use the font, 
the application passes in a font 





Figure 1. Skeleton of the basic Window class (continued on page 60) 
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name that it will use later. 

So, the PAINTBRUSH keeps a list of 
font IDs associated with it. This 
puts the PAINTBRUSH in a position to 
manipulate font IDs to match its 
current state as needed. It also 
allows it to destroy any associated 
font IDs when the presentation 





space is destroyed to avoid a com- 
mon error of stranding font IDs 
and running out of them later. 


DIALOG WINDOWS 

Dialog windows pose more prob- 
lems. There are some basic ap- 
proaches: You can call WinLoadDlg(), 
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which will load up the dialog and 
create all the controls. Then, you 
can create after-the-fact window 
objects for all the controls. But we 
wanted to allow each dialog-win- 
dow-derived class to control the 
creation of the control windows so 
that more specialized versions 
could be created and initialized in 
a way that is appropriate for that 
dialog. We could have passed the 
window handle and Presentation 
Manager window class of each of 
the controls to the derived class, 
but that would expose Presen- 
tation Manager-specific informa- 
tion to the outside world. 

We solved this problem by 
interpreting the dialog template 
manually, allowing the basic dia- 
log class (or a derived class) to 
handle the creation of the controls. 
Reading a dialog template is not as 
difficult as it might seem, except 
that the documentation is ex- 
tremely insufficient. Again, do not 
create a virtual method to allow 
derived classes to handle control 
creation because the creation hap- 
pens in the constructor. We used a 
callback function passed to the 
constructor. The Presentation 
Manager class type is converted to 
the equivalent class name, and any 
control size and position informa- 
tion is passed along. If the callback 
returns a null pointer, the dialog 
window creates the default type of 
window object. 

By the way, another good use 
for this knowledge is for building 
dialog templates in memory on the 
fly and letting the dialog process- 
ing code handle the grunt work of 
user interaction. 

The devil is in the details, but 
these are the basic steps to handle 
your own dialog creation. First, 
use DosGetResource() to load the dia- 
log resource. This gets you a read- 
only buffer with the template defi- 
nition. Load the address into a 
PDLGTEMPLATE variable to start the 
parsing. The last field of the DLGTEM- 


PLATE structure is an array of 
DLGTITEM records, but the array has 
only one entry since the actual 
number of dialog items following 
the template is variable. 

Use a PDLGTITEM variable to 
work your way through the dialog 
item structures (pItem = &pDlg->adl- 
gti[0]). The 0th dialog item repre- 
sents the dialog window itself. 
Each dialog item structure contains 
the information you need to create 
that item and the number of child 
windows it has. The child win- 
dows follow it in the list, so the 
arrangement is “depth first.” In 
our system, we do not support 
nested dialog controls, so we 
worry only about the number of 
children of the dialog itself. 

Next, create the dialog window 
frame using the information in the 
first dialog item structure. You will 
need to check the styles to find out 
whether the size and position infor- 
mation is relative to the screen, par- 
ent window, or mouse and then 
add the dialog position to the origin 
of the screen or window or to the 
current mouse position. The control 
data for the dialog is a ULONG with 
the FCF_xxxxx flags in it. You need 
this to create the frame window 
with the correct frame controls. 

For the modal processing to 
work correctly, you must calculate 
the correct owner of the dialog, 
which will not always be the 
owner window that the user 
passed. So, starting with the owner 
window that the user indicated, 
use WinQueryWindow() to work up the 
ownership chain until you reach a 
window that is a direct child of the 
desktop window or a null window 
handle. Pass this window as the 
owner of the frame window. If you 
do not do this, often you will find 
that the supposedly modal dialog 
does not stop you from interacting 
with other application windows. 

Now, call WinCreateWindow() to 
create the frame, passing a FRAMEC- 
DATA structure as the control data. 


At this point, just create it so it is 
invisible and has no size. You 
don’t know the size at this point 
because the size information in the 
dialog item is actually the size of 
the “client area” of the frame 
(although there is no real client 
window in a dialog). 
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After frame creation, use the 
dialog item size and position infor- 
mation in a call to WinCalcFrameRect() 
to calculate a frame that will con- 
tain a client area of that size. Before 
you size and position the frame, 
adjust the values to ensure that it 
does not hang off the screen. Then, 
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you can size and position the 
frame (but not show if you want to 
process it modally). To make the 
client area display the correct color, 
use WinQuerySysColor() to get the 
SYSCLR_DIALOGBACKGROUND color. Call 
WinSetPresParam to set the frame’s 
PP_BACKGROUNDCOLOR. 

Now, you can loop through the 
remaining dialog items (which rep- 
resent dialog controls) and create 
them as owned children of the 
frame. One oddity is that you must 
start at the last control and work 
backward to make the Presentation 
Manager dialog window's tab key 
code work correctly. By going in 
reverse, the first control in each 
group (which has the WS_GROUP 
style) will be the last window cre- 
ated in the group. 

If you intend to support nested 
controls, you should do this via a 
recursive call. Note that, since 
dialogs have no client window, 
you actually create the controls rel- 
ative to the frame. The position 
information in each dialog item 
does not take this into account, so 
use the WM_QUERYBORDERSIZE message 
to get the border size and add it to 
the origin of each control. 

All size and position informa- 
tion in dialog templates is in dialog 
units, not pels. Use the Win- 
MapDlgPoints() function to map the 
dialog units to pels before using 
them. And last, the dialog template 
structure contains the index of the 
control that should get the initial 
focus. If it is OxFFFF, use WinEnum- 
DigItem() with the EDI_FIRSTTABITEM to 
find the first item with the WS_TABSTOP 
style and give it the focus. 

Now, you can either use the 
newly created window like a regu- 
lar window (which is useful for 
creating your program’s main win- 
dows via the Dialog Editor) or pro- 
vide a method in the dialog class 
that calls WinProcessDlg() to process 
the dialog modally. Initially set the 
default procedure to the default 
window procedure. If the dialog is 





Figure 1. Skeleton of the basic Window class (continued from page 57) 


later processed modally, switch it 
to the default dialog proc to avoid 
problems. 


POINTS AND RECTANGLES 

One of the best things you can do 
for yourself in a GUI class system 
is to create powerful and flexible 
classes for dealing with points and 
rectangles. There are three reasons 
for this. 

First, two types of rectangles 
are in Presentation Manager, inclu- 
sive and noninclusive. In Presen- 
tation Manager applications, a con- 
stant problem is keeping up with 
which kind of rectangle is required 
and which kind you have. 

Second, any new platform you 
port to may have totally different 
concepts for rectangles. 

Third, you waste a vast 
amount of time in the average, 
large Presentation Manager appli- 
cation doing grunt work calcula- 
tions and manipulations on points 
and rectangles. Such code is inher- 
ently Presentation Manager-centric 
and ripe for maintenance errors. 

We eliminated this problem by 
creating a POINT class to handle 
points and an AREA to deal with rec- 
tangles. The AREA class represents a 
POINT origin and a width and 
height value that is always inclu- 
sive. The outside world deals 
exclusively with POINTs and AREAs, 
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and the lowest-level class methods 
(that actually call Presentation 
Manager) handle converting in 
and out as needed. 

The AREA class is particularly 
powerful; it inflates and deflates 
itself, calculates its center, calcu- 
lates horizontal and vertical per- 
cents of itself, centers other areas 
within itself, offsets its origin, and 
so on. The more standard opera- 
tions you incorporate into the AREA 
class the better. It should have 
methods and constructors that 
build AREAs from RECTLs, a POINTL and 
width and height, two POINTLs that 
represent opposite corners, SWP 
structure, and so on. It should also 
have methods to create these 
Presentation Manager structures 
from an AREA, which greatly simpli- 
fies the internal code that has to do 
the conversions. 

The use of POINT objects can be 
eased greatly by storing the mem- 
bers in the same order as a POINTL 
and having an implicit conversion 
operator that references the 
address of the x member. This 
allows POINT objects to be passed 
directly to GPI calls with no inter- 
vening conversion. 


PRESENTATION MANAGER 

TYPES AND BIT FLAGS 

One way to increase the type safe- 
ness and portability of your class 


system (without introducing over- 
head) is to redefine the Pre- 
sentation Manager types as C++ 
enumerated values. C++ allows 
enumerated values to be given 
explicit values, so you can create, 
for instance, an enumerated value 
called eLINESTYLES for the LINE- 
TYPE_xxxxx Presentation Manager 
values. 

If your line type setting 
method accepts an eLINESTYLES 
parm, it gets much stricter type 
checking than the generic bit flags 
that Presentation Manager uses. 
But, internally, the line style setting 
method can pass the enumerated 
value on to the GPI API, and the 
compiler will convert the enumer- 
ated value automatically to a long 
value. A side effect of this trick is 
that you keep Presentation 
Manager-centric constants and 
types out of the source code, eas- 
ing future ports. It also allows the 
class designer to exclude certain 
flags because those flags may limit 
portability. 


THE BIG PICTURE 
If you decide to write your own 
Presentation Manager class sys- 
tem, be aware that you likely will 
be very frustrated. C++ represents 
such a great step in power over the 
procedural systems (upon which 
most class systems must be imple- 
mented) that a totally consistent 
class system might be impossible. 

We started the classes by 
mainly implementing basically run- 
time-oriented services, such as 
strings and containers. Since these 
services depend only on memory 
allocation, they are free to follow 
almost any consistent class mecha- 
nisms you implement. The kernel 
services that followed were also 
quite easy because most kernel ser- 
vices are passive and do only what 
you tell them. Threads were not too 
difficult. 

Then came the GUI, whose 
complexity, event-driven nature, 


and troublesome resource interrela- 
tionships often stymied my plans. 
This is irksome even now because | 
feel that consistency is next to godli- 
ness in class system development. 
Developer spin-up time and reac- 
tionary fire-drill programming are 
very expensive, and inconsistency 
greatly increases spin up and 
decreases reliability. A class system 
in total control can provide many 
more safety nets and self examina- 
tions, quickening development and 
relieving much of the testing burden 
for the developer and putting it into 
the code itself. 

The object-oriented frame- 
works and (eventually) operating 
systems to come from IBM will 
reduce these problems greatly by 
providing an object-oriented plat- 
form to build on. Of course, the 
irony is that they also will make 


most of the effort that I have dis- 
cussed here redundant. 

If you can’t wait, be sure to 
take a good look at the operating 
methods of your future object-ori- 
ented program’s framework. 
Then, arrange your class system 
accordingly. Hopefully, you will 
be able to just pull out your 
lower-level classes and replace 
them with new ones, leaving your 
higher-level (application-specific) 
classes mostly intact. It may never 
happen, but you have to try! 


Dean Roddey /s senior software engineer 
at Quantitative Medicine of Annapolis, 
Md. He has a relationship with his com- 
puter that is probably illegal in some 
states, but he is seeking help. He is cur- 
rently working to move QMI’s OS/2-based 
Clinical Information System to an object- 
oriented platform. 
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monitor is a reality. 
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The IBM Pen for OS/2 product enables applications to cross the human-centric barrier. This article 
explores an example of how a pen-centric application should be designed and how simple it can be to 
develop using Pen for OS/2. By SARKA J. MARTINEZ 


A Natural User Interface: 


Writing a Pen-Centric 


Application 


en technology has introduced a 
whole new set of possibilities in 
the world of application software. 
Software can now be written in pen-cen- 
tric fashion. Pen-centric applications are 
those that have been written expressly 
with pen entry and manipulation in 
mind. A pen-centric application can per- 
form specific preprogrammed tasks as a 
result of what a user does with the pen, 
be it handwriting or gesture entry. 
Application programming takes on 
an exciting aspect when coupled with 
OS/2's pen extensions. One such pen- 
centric application is called Contact/2. 
Contact/2 is a demo application I wrote 
in five weeks while working in IBM’s 
Mobile, Pen, and Voice (MVP) software 
development team. A unique approach 
was taken in developing Contact/2, the 
core ideas being the pursuit of an inter- 
face using a real-world paradigm, the 
value of function, and of course an easy- 
to-use pen-centric approach. This appli- 
cation is an example of how you can 
add pizzazz to your applications and 
improve their ease of use by the mere 
fact that they follow a real-world model. 





P 


CONTACT/2. A PEN-CENTRIC DEMO 

Basically, Contact/2 is an address book. Its 
intention is to communicate with the peo- 
ple and business contacts stored within 
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the book. This application achieves its 
entry into the real-world paradigm by 
being represented as a true-life book, com- 
plete with a cover, book tabs, business 
cards, and an index page. There’s even the 
capability to attach jotted down memos 
via sticky pads to any entry in the book. 
Contact/2 can give the user a simple 
way to communicate with other people 
via fax, e-mail, telephone, alphanumeric 
paging, or LAN messaging. It includes 
some multimedia capabilities; it allows 
the playback of prerecorded messages 
attached to the cover, the index page, and 
the book’s entries (so that the people in 
your book can tell you a little about them- 
selves). Communications functions were 
tied in easily by the use of OS/2's 
dynamic data exchange (DDE). By using 
DDE and off-the-shelf applications, we 
saved a lot of time and money by not 
having to develop new code or compete 
with existing communication software. 


THE DESIGN APPROACH 

Our approach in designing this particular 
application was different. The emphasis 
was on visuals—something often saved 
for last. The coding was merely an 
enabler for the end result. Painstaking 
care was taken up front to create the look 
and feel of an actual book, including the 
artwork for its dramatic cover. 
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LOOK AND FEEL FIRST 

First we designed the book’s over- 
all visual appearance and user 
interface using PowerPoint 3.0. 
Next, the graphics for the cover 
(welcome page) of the book were 
created using CorelDraw 3.0 and 
Adobe Photoshop 2.5. The images 
were saved as bitmaps and are dis- 
played on the welcome page when 
its dialog box is loaded. 

Notebook Control—Made to 
Order. After the user interface 
design and visuals were created, 
work began on implementing the 
interface using the Notebook control. 
If there has ever been a question as 
to when to use the Notebook control, 
this sort of application is what it 
was intended for! There is no bet- 
ter vehicle in representing this type 
of information to a user. 

After we had finished the user 
interface framework, we created a 
database to store address book 
entry information. Along with 
storing the usual information, we 
added the ability to store a bitmap 
for each of the entries. We created 
generic bitmaps, using OS/2’s Icon 
Editor for male and female entries, 
and a bitmap to indicate a business 
entry. We provided a way for users 
to add their own bitmaps. 

Next, the pen portion was 
enabled by using several Pen for 
OS/2 APIs and messages. Last, 
DDE was folded into the code, 
enabling Contact/2 to communicate 
with various off-the-shelf “helper” 
applications such as IBM’s Mul- 
timedia Extensions, cc:Mail, and 
other communicating applications. 
From design to coding, everything 
was done on OS /2 2.1. 


THE GESTURES 

Pen for OS/2 APIs follow the 
same format as other OS/2 2,1 
APIs, making it easy to learn. 
Anyone creating software can be 
a quick study in getting pen capa- 
bility into their applications. Let’s 
take a look at how simple it is. 
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Figure 1. The cover of the Contact/2 address book 


Pen plays a major role in 
Contact/2’s book paradigm in 
both navigation and the initiation 
of its communication features. 
Following is a list of Contact/2 
premapped gestures achieved by 
using the Pen for OS/2 messag- 
ing framework. The gestures 
defined by Pen for OS/2 retain 
their predefined function unless 
overridden by another applica- 
tion’s mapping. There are 58 ges- 
tures available for mapping: 

8 Forward a page 
= Backward a page 
Remove entry 
Add entry 
Update entry 
Copy 

Help 


oO cc = 
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to send mail 

to call pager 

to add card 

to remove card 
to update card 
play voice clip 
copy to clipboard 
for help 





Print (output) 

Send Pager Message 

Dial a number 

Play a voice capsule 

Mail a note 

send a fax 

send a LAN message. 
Letter gestures involve a tap of 
the pen as the final stroke. 

How does Pen for OS/2 deter- 
mine if a user is entering a gesture 
rather than a letter (handwriting 
recognition)? It all comes down to 
pauses. As long as a user does not 
pause the pen on the tablet before 
or during the execution of drawing 
a gesture, the system will treat it a 
gesture. If a pause is present, the 
system will attempt to recognize it 
as a letter. 


renee owo 


RECOGNITION 

Gesture and handwriting recogni- 
tion can be monitored and acted 
upon by processing the WM_RECO 
message. An application receives 
a WM_RECO message whenever a 
recognition event occurs. The 
Contact/2 application redefines 
several gestures. Thus, the appli- 
cation performs special process- 
ing of the WH_RECO event to over- 
ride the system’s default 
processing of the gesture. 

In our application, several 
window procedures are defined; 
each time a recognition event 
occurs on one of these windows, I 
repost the parameters that enter 
into the WM_RECO event into a mes- 
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Figure 2. Entries are represented as business cards 





sage called WM_MY_RECO, which is 
defined in the topmost client win- 
dow (the Notebook control). By 
doing this, we need to define only 
one procedure to handle all the 
gesture processing information. 
When you process a WM_RECO 
message, the second message 
parameter contains the RECODATA 
structure. A virtual ID can be 
accessed through this structure. 
The virtual ID indicates whether 
the gesture was a letter gesture or 
another specific symbol gesture. 
If it is determined that the gesture 
was a letter gesture, the character 
code stored in the RECODATA struc- 
ture can be accessed. This will let 
you determine exactly which let- 
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ter gesture was recognized. 

Finally, a value of TRUE must 
be returned from the WM_RECO event 
to override the system’s default 
execution of the gesture. Notice 
that the gesture’s hot-spot coordi- 
nates can be mapped easily to the 
corresponding window handle 
that resides at that coordinate. 
This can be achieved by using the 
WinMapWindowPoints API, which is 
detailed in Figure 3. 

Handwriting recognition can 


also be achieved easily with the 


use of the Handwriting control. No 
special message capture or mes- 
sage sending needs to be made. 
Handwritten words are recog- 
nized automatically as long as a 
value of FALSE is returned from 
the WM_CONTROL event. This can be 
done by returning the result from 
WinDefWindowProc in the WM_CONTROL’s 
default case statement. This 
causes the system to take default 
processing of handwriting recog- 
nition events. The code segment 
in Figure 3 shows how to process 
recognition messages for gestures. 


THE SKETCH CONTROL 

A user can access the sticky pad 
by tapping on the paper clip but- 
ton. This interface is intended to 
let a user jot down quick notes 
about an entry. Contact/2’s sticky 
pads were created using the sketch 
control provided by Pen for 
OS/2. Finally, a way to jot down 
thoughts through sketching! This 
is shown in Figure 4. 

The sketch control was in- 
cluded into a dialog box within a 
-DLG file. The dialog procedure 
needs to process SKN_STROKE_ADD 
messages to save the strokes that a 
user may draw in to the control. 
Then, these strokes can be saved 
into a file and later be retrieved for 
display purposes. This is shown in 
Figure 6. These saved strokes 
could also later be recognized and 
transformed into text (delayed 
recognition). 





Figure 3. Code enabling gesture recognition (continued on page 67) 
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Figure 3. Code enabling gesture recognition (continued from page 66) 
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Figure 4. The sketch pad interface 
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Basically, the SKN_STROKE_ADD mes- 
sage stores all the strokes in a stroke 
buffer that can later be retrieved 
using the SKM_QUERY_CTL_STROKE_COUNT, 
SKM_QUERY_STROKE_LENGTH, and SKM_ 
QUERY_STROKE_DATA messages. These 
messages can, in turn, allow you 
to store the information to a file. 
You can put stroke information 
back into a buffer to allow sketch 
replay. This can be done by insert- 
ing the stroke data into the SKETCH- 
STROKEDEF data structure. You can 
redisplay the stroke information 
stored in this data structure by 
sending the SKM_ADD_STROKE mes- 
sage to the sketch control. This is 
shown in Figure 7. Sending the 
message SKM_DELETE_ALL_STROKES to 
the sketch control allows the clear- 
ing out of the control’s sketched 
contents. By sending the 
SKM_UNDO_LAST_STROKE message to the 
sketch control, a user is able to 
undo a stroke within a sketch, 
one stroke after another, until 
nothing is left. You can modify the 
pen’s ink color sending the sketch 
control the SKM_SET_CTL_INK_COLOR 


Figure 5. Window procedure that controls aspects of the sketch control 
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Figure 6. Code that saves sketch strokes to a file (continued on page 7/0) 
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Figure 6. Code that saves sketch strokes to a file (continued from page 69) 


Figure 7. Code that reads stroke data from a file and redisplays the strokes in a sketch control (continued on page 71) 
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gure 7. Code that reads stroke data from a file and redisplays the strokes in a sketch control (continued from page 70) 
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Figure 8. The index page 


message along with the desired 
ink color. The code in Figure 5 
shows how to use these messages. 


THE INDEX PAGE 
The Index page allows a user to see 
all of the entries in a book at a 
glance. Additional function has 
been added to this page by allow- 
ing a user to filter on all of the 
fields displayed for entries in the 
index view. The fields include first 
and last name, company, and state. 
Once a field is chosen, a combed 
handwriting control is displayed, 
allowing the user to hand write in 
the text. This is shown in Figure 8. 
As each character of the text is 
recognized, the Container control 
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(list) filters out the entries that do 
not match the filter criteria. At any 
point, a user can tap on a name 
and the book will automatically 
turn to that entry’s corresponding 
page. Also notice that the available 
types of communications for each 
entry in the book are indicated by 
the graphics symbol before each 
name. Figure 8 contains an exam- 
ple of the index page. 


OTHER TIPS 

Remember not to overdo hand- 
writing entry recognition. Gen- 
erally, you should support hand- 
writing entry but not require it. 
Even though handwriting recog- 
nition is an exciting new technol- 
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ogy, it is still much simpler, 
quicker, and more reliable for a 
user to be able to tap with a pen 
rather than handwrite something. 
For example, it is better to create 
a list of selectable items than force 
the user to enter an item. Restrain 
your recognizable set of charac- 
ters, if possible. For example, if 
your application is interested 
only in numbers, limit your rec- 
ognizable character set to num- 
bers. This will improve your 
recognition results. The capability 
to constrain the recognizable 
character set by allowing the pro- 
grammer to specify various char- 
acter sets or even individual char- 
acters is being considered for 
future releases of Pen for OS/2. 
Future releases of Pen for 
OS/2 may also support handwrit- 
ing recognition in single-line 
entry fields and multiline entry 
fields systemwide. In addition, 
ruled and unruled text entry may 
be available. If you know that 
your users will use the applica- 
tion with pen only (no keyboard), 
get rid of keyboard- and mouse- 
centric constructs such as double 
tapping, mouse button 2 scenar- 
ios, the concept of default buttons 
and highlights, pneumatics, and 
so on. Overall navigation should 
be achieved with mere taps of the 
pen. Another natural use of Pen 
Extensions is the enablement of 
allowing users to annotate on top 
of existing electronic documents. 
Also, remember to replace 
key macros with gesture macros. 
Most of all, from the onset of your 
pen-centric application's design, 
remember that the user will now 
be using a pen. It is a new para- 
digm; users will want to interact 
differently with your application. 
It should feel more like pen and 
paper. As the user becomes more 
experienced with the pen envi- 
ronment, the application’s con- 
straints of the mouse and key- 
board should become less 


evident. A pen-centric application 
should be designed from the 
ground up for use with pen-based 
computers. The best way to 
achieve a pen and paper-like 
application is to design from the 
outside (look and feel) to the in- 
side (code). The interface should 
require minimal computer knowl- 
edge on the part of the user. 

‘Special thanks to Anthony E. 
Martinez for supplying the graph- 
ics work and ideas for the user 
interface representation. Also, I 
thank Janice Roberts for giving me 
the opportunity to create this 
application and her ideas for the 
index page. 


Sarka J. Martinez, joined /BM in 1988 
and is a senior associate programmer in 
the mobile applications software arm of 
the Mobile Pen and Speech (MVP) team in 
Boca Raton, Fla., which is part of the PSP 
division. Over the years, Martinez has 
worked on various advanced technology 
projects and is now involved in designing 
and implementing applications for IBM's 
PDA software solution. She received a B.S. 
in computer science at the State Uni- 
versity of New York at Buffalo. Martinez 
has also received several patents for 
graphical user interface techniques. 
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The staff of 0S/2 Developer put together this special section to guide you through the various 
compilers and interpreters available for OS/2. The products described in this guide are based on surve ys 
sent to vendors, they are provided as a service to you and are free to vendors. These listings do not rep- 


resent an endorsement by 0S/2 Developer. A/though every effort has been made to ensure accuracy, we 


do not assume any responsibility for error or omission in this section. Please contact the companies 
directly for more information. 


Compilers and Interpreters 
Buyer’s Guide 
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ACUCOBOL INC. Circle No. 101 
Acucobol-85 2.1.1 for OS/2 2.0 and 
Acucobol-85 2.1.2 for OS/2 1.3 compilers 
offer machine-independent code that is 
portable, without recompiling, across dif- 
ferent platforms, including AIX, AOS, MS- 
DOS, NetBIOS, OS/2, Ultrix, UNIX, 
XENIX, and VMS operating systems. The 
compilers include extensions for boxed 
and reverse video windows; pop-up win- 
dows; color; scrolling; machine-indepen- 
dent handling of file and directory names; 
file, record, and device locking; index file 
compression and encryption; system and 
terminal information; delete file; and read- 
ing of locked records. Acubol-85 also 
incorporates screen section support, DG- 
ICOBOL compatibility, a user-replaceable 
file system, and hot keys. Price: Please 
contact vendor. 

Acucobol Inc., 7950 Silverton Ave., 
Ste. 201, San Diego, Calif. 92126, (800) 262- 
6585 or (619) 689-7220, fax (619) 689-7251. 


ARITY CORP. Circle No. 102 
Arity/Prolog32 1.0 provides floating-point 
arithmetic, a menu-driven/ windowed 
programming environment, a built-in edi- 
tor, text string support, definite clause 
grammar support, and embedded inter- 
face to other programming languages. It 
provides support for concurrent Prolog 
execution, including a virtual database 
that supports two gigabytes of memory 


and provides sequential, hashed, and b- 
tree indexing. It supports Microsoft 
Languages, Lattic C, and Assembly. 
Arity/Prolog32 contains a C compiler 
capable of handling C declarations and C 
expressions embedded with Prolog source 
code. The user can call C or Pascal func- 
tions from inside Prolog. The user can also 
call Prolog from C and Pascal and inter- 
face with dynamically linkable libraries. 
Price: $2,450.00. 

Arity Corp., Damonmill Sq., Concord, 
Mass. 01742, (800) 369-5622 or (508) 371- 
1243, fax (508) 371-1487. 


BORLAND 
INTERNATIONAL Circle No. 103 
Borland C++ 1.5 for OS/2 includes tem- 
plates, exception handling, run-time type 
information, and ANSI string classes. It 
takes advantage of OS/2’s multithreaded, 
multitasking environment and includes 
32-bit optimizations and a Presentation 
Manager-hosted integrated device elec- 
tronics. Other features include Borland 
BPMCC (custom controls) and Borland’s 
ObjectBrowser for graphically displaying 
class hierarchy. Borland C++ for OS/2 
also includes a free copy of Borland Turbo 
Assembler. Price: $199.95; $79.95, upgrade. 
Borland International, 100 Borland 
Wy., Scott Valley, Calif. 95066-3249, 
(800) 331-0877 or (408) 431-1000, fax 
(408) 431-9119. 
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CABOT SOFTWARE LTD. Circle No. 104 
UCSD Pascal Compiler is integrated with 
Presentation Manager, allowing full 
Presentation Manager applications in 
Pascal. It is also integrated with the Power 
System development environment, which 
includes a set of programming tools and 
facilities: command menu with window- 
ing and pop-up and pull-down menus; 
test and program editor; print utility to 
allow control of headers, pagination, for- 
mat, spacing, and paper; library manager 
to add or remove generic code segments 
from code library; and file transfer. 
Applications generated by the Power 
System are stored in P-Code, a machine- 
independent programming standard that 
supports compact code files that can be 
smaller than the source text file. Price: 
$299.00 

Cabot Software Ltd. The Vicarage, 
Stoke View Rd., Bristol, U.K. +44-272- 
586644, fax +44-272-586680. 


CALIFORNIA SOFTWARE 

PRODUCTS INC. Circle No. 105 
BABY/4XX 1.5 enables the user to downsize 
AS/400 native code from a midrange sys- 
tem to the PC where it can be recompiled 
and used on a network or in multiuser or 
single-user mode. Running under OS/2, 
BABY /4XX allows the user to integrate 
AS/400 applications with DOS, Windows, 
and OS/2 software, such as word proces- 
sors, spreadsheets, and databases. When 
used in conjunction with Novell NetWare, 
BABY /4XX provides client/server capa- 
bility. Price: $3,500.00. 

BABY/AS 4.0 development systems 
permit the development and execution of 
IBM System/36 and AS/400 PRG II appli- 
cations on IBM-compatible PCs. Running 
under OS/2, BABY/AS allows the user to 
integrate RGP II applications with DOS, 
Windows, and OS/2 software. BABY/AS 
can be used on a network or in multiuser 
or single-user mode. Price: $3,500.00. 

California Software Products Inc., 525 
N. Cabrillo Park Dr., Santa Ana, Calif. 
92701-5017, (800) 841-1532 or (714) 973- 
0440, fax (714) 558-9341. 
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CATSPAW INC. Circle No. 106 
SPITBOL-386 1.28 is an implementation of 
the SNOBOL4 programming language. It 
features a vocabulary of string manipula- 
tion primitives for pattern matching and 
text analysis. Applications include conver- 
sion; reformatting; analysis of text; litera- 
ture and music analysis; and program pro- 
totyping. Price: $295.00. 

Catspaw Inc., P.O. Box 1123, Salida, 
Colo. 81201, (719) 539-3884, fax (719) 
539-4830. 


COMPUTER ASSOCIATES 

INTERNATIONAL INC. Circle No. 107 
CA-REALIZER 2.0A is a visual development 
tool that enables the development of cross- 
platform applications for individual, 
workgroup, and company-wide needs. 
This BASIC Construction Set is available 
on any system compatible with OS/2 2.1 
or higher as well as Windows 3.1. CA- 
REALIZER helps the user create spread- 
sheets, charts, text editors, animation, 
graphics tablets, and forms from tools. 
Price: $99.00. 

Computer Associates International 
Inc., One Computer Associates Plaza, 
Islandia, N.Y. 11788-7000, (800) 225-5224 
or (516) 342-5224, fax (516) 342-5734. 


DATA ACCESS CORP. Circle No. 108 
DataFlex 3.05 for OS/2 2.1 is an application 
development environment that includes a 
relational DBMS and an object-oriented, 
procedural fourth-generation language. 
This 32-bit character-cell tool allows users 
to share files with DataFlex for DOS or 
Windows users and interface with the 
DataFlex server. Price: $795.00, single-user 
development; $995.00+, multiuser. 

Data Access Corp., 14000 SW 119th 
Ave., Miami, Fla. 33186, (800) 451-3539 or 
(305) 238-0012, fax (305) 238-0017. 


DIGITALK Circle No. 109 
PARTS Workbench 2.0 for OS/2 is a client/ 
server integration tool that enables appli- 
cation development through assembly and 
reuse of application components. The 
Workbench comes with over 65 prebuilt 
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components, both visual and nonvi- 
sual. The user can write other com- 
ponents in Smalltalk/V, C, COBOL, 
or other languages. Price: $1,995.00. 

Smalltalk/V 2.0 for OS/2 is a 32- 
bit, object-oriented development 
environment for OS/2. It contains a 
set of tools for developing graphical, 
portable, CUA-compliant applica- 
tions. Smalltalk/V includes a re- 
usable class library, a push-button 
debugger, browsers, inspectors, and 
an incremental compiler. Price: 
$995.00. 

Digitalk, 5 Hutton Centre Dr., 
Santa Ana, Calif. 92707, (800) 922- 
8255 or (714) 513-3000, fax (714) 
513-3100. 


EDV— 
KOHLENBACH Circle No. 110 
KIM 2.0 is a database developing sys- 
tem with a BASIC-like programming 
language and a dBase-compatible 
database engine. A free license run- 
time kit is available. KIM enables 
users to build OS/2 Presentation 
Manager programs. Price: $150.00. 
EDV Buero Kohlenbach Soft- 
ware-Entwicklung, 8502 Winters- 
dorf, Blumenstr. 58e, Germany - 
90547 Stein, +49-911-688-9040-1, fax 
+49 9183-242. 


GLANCE AG Circle No. 111 
Modula-2 to C Translator type M2CC 4.5 
is a compiler system that translates 
Modula-2 applications into C. It 
enables the user to transfer Modula- 
2 programs from a VAX/VMS sys- 
tem to a DEC/Alpha machine, for 
example, The M2CC/C Modula-2 to 
C Translator also supports other sys- 
tems with a C development environ- 
ment, such as DOS, OS/2, and UNIX 
systems. The translator is also suit- 
able for new and cross development 
of Modula-2 applications. Price: 
$2,250.00; $6,700.00 for workstations. 

Glance AG, Gewerbestrasse 4, 
CH-8162 Steinmaur, Switzerland, +41 
(1) 853-39-49, fax +41 (1) 853-08-09. 


GPF SYSTEMS INC. Circle No. 112 
GpfRexx provides WYSISYG, visual, 
OS/2 Presentation Manager pro- 


gramming with REXX, It allows the 
user to point and click to create 
CUA'91 applications. The Gpf 
Interface Builder handles the logic 
for managing events, windows, con- 
trols and their data, and for display- 
ing help. Other features include mul- 
timedia, drag/drop, multitasking, 
SQL (DB2/2), and communications 
(APPC, CPI-C, EHLLAPI). No royal- 
ties. Price: Please contact vendor. 

Professional Developer's Toolkit 
provides support for OS/2 2.x, OS/2 
1.3.x, and Windows 3.0 and 3.1. It 
allows the user to point and click to 
create CUA‘91-compliant GUIs. It 
generates C or C++ source, help 
source, and ancillary files, GpfTools 
enables manipulation and automatic 
documentation of Gpf designs. Price: 
$1,440.00. 

Gpf Systems Inc., 30 Falls Rd., 
P.O. Box 414, Moodus, Conn. 06469, 
(800) 831-0017 or (203) 873-3300, fax 
(203) 831-3302. 


HOCKWARE INC. Circle No, 113 
VisPro/REXX 2.0 uses OS/2, 
Workplace Shell, and the REXX lan- 
guage as a visual programming 
environment. It provides the user 
with a development environment for 
creating, testing, debugging, modify- 
ing, and distributing OS/2 2.x GUI 
programs. VisPro/REXX is royalty- 
free. Price: $99.00 to $299.00+. 
Hockware Inc., 315 N. Academy 
St., Ste. 100, Cary, N.C, 27515, (919) 
380-0616, fax (919) 380-0757. 


IBM Circle No, 114 
APL2 for 0S/2 Entry Edition 1.0 is a pro- 
gramming language for application 
program developers and interactive 
users. It can be used to develop both 
commercial and scientific applica- 
tions, “what-if” modeling, explor- 
atory programming, interactive com- 
puting, decision support, and data 
analysis. It includes a Presentation 
Manager interface, graphics facili- 
ties, calls to other languages, and 
large work spaces. APL2 for OS/2 is 
compatible with the APL2 family of 
products, which run on IBM 
System/370 and System/390 with 
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CMS or TSO, the IBM RISC 
System/6000 with AIX/6000, the 
Sun SPARCstation with Solaris, and 
all personal computers with DOS. 
Part #89G1556. Price: $185.00. 

APL2 for OS/2 Advanced Edition is 
a programming language for appli- 
cation program developers and 
interactive users. It can be used to 
develop both commercial and scien- 
tific applications, “what-if” model- 
ing, exploratory programming, inter- 
active computing, decision support, 
and data analysis. It includes all of 
the features of the Entry Edition plus 
relational database access, tools for 
writing auxiliary processors, a per- 
formance monitor, and the ability to 
distribute data and processing 
among multiple APL2 systems con- 
nected through TCP/IP. APL2 for 
OS/2 is compatible with the APL2 
family of products, which run on 
IBM System/370 and System/390 
with CMS or TSO, the IBM RISC 
System/6000 with AIX/6000, the 
Sun SPARCstation with Solaris, and 
all personal computers with DOS. 
Part # 89G1697. Price: $650.00. 

PL/I for OS/2 1.1 Professional 
Edition is an Operating System/2* 
(OS/2*) Version 2 based PL/I appli- 
cation development environment. It 
is designed for the experienced PL/I 
application developer who wants to 
have the power of the host language 
combined with the productivity of 
the PC tools. This compiler gives the 
PL/I application programmer the 
capability to write “client/server” 
applications in PL/I that access data 
on MVS, VM, AIX/6000, and OS/2. 
It is integrated with the DB2 family 
of products, with IMS Client 
Server/2, and with IBM's CICS fam- 
ily of products. The Toolkit—a sepa- 
rately priced feature—provides a set 
of valuable tools for visual building 
of screens for Presentation Manager. 
Part #10H7848. Price: $750 (must 
order on or before Sept. 30, 1994, to 
receive this price). 

PL/I for OS/2 1.1 Personal Edition is 
a full function Operating System/2* 
(OS/2*) Version 2 based PL/I appli- 
cation development environment. It 


is designed for the PL/I application 
developer who wants to have the 
power of PL/I language available on 
a standalone PC or a small LAN. 

IBM PL/I for OS/2 Personal 
Edition is ideal for programmers 
writing new PL/I applications that 
do not require access to mainframe 
data. Its applications can call Pre- 
sentation Manager APIs, C-based 
applications or tools, and applica- 
tions or tools written in REXX. The 
Toolkit—a separately priced fea- 
ture—provides tools for visual 
building of screens for Presentation 
Manager. Part #10H7819. Price: 
$299.00, Toolkit (part #1322966) is 
$199.00. 

IBM, 555 Bailey Ave., San Jose, 
Calif. 95141, (800) 426-2255, sales 
(408) 463-4871, technical (408) 463- 
4363, fax (408) 463-4820. 






G dbfREXX allows reading 
and writing dBASE files 
from your OS/2 REXX 
programs! 

C$ dbfLIB includes support 

for DOS, Windows, 

OS/2 and Windows NT 

all in one package! 


Sales (405) 360-3045 
Tech Support (713) 537-0318 
Visa and MasterCard accepted. 





Read and Write dBASE files 
from C, C++, and now REXX! 


LESTEC PTY. LTD. Circle No. 115 
Modular And Integrated Design (MAID) 
1.1 is an interface designer that helps 
the user create a repository of inte- 
grated working objects containing 
REXX event scripts. Features 
include multithreaded support; 
interdialog communication; a suite 
of subcommands and functions; and 
an external REXX and C interface. 
MAID provides support for data- 
base and host communications. 
Price: $199.00. 

Lestec Pty. Ltd., P.O. Box 1394, 
Dee Why, NSW 2099, Australia, +61 
(2) 981-5925, fax +61 (2) 981-5925. 


METAWARE Circle No. 116 
High C/C++ 3.2 for OS/2 is a 
“DirectToSOM” compiler. It enables 
the user to compile large programs 
and generate code. It is ANSI-com- 








patible and provides support for 
C++ templates and exceptions. High 
C/C++ includes IBM’s OS/2 
Developer’s Toolkit and DLL’s to 
link into the WorkFrame/2 inte- 
grated environment. MetaWare 
offers free technical support and a 
money-back guarantee. Price: 
$595.00; $495.00, if user of another 
MetaWare compiler. 

MetaWare, 2161 Delaware Ave., 
Santa Cruz, Calif. 95060, (408) 429- 
6382, fax (408) 429-9273. 


MICRO DATA BASE 

SYSTEMS INC. Circle No, 117 
Object/1 3.0 is an object-oriented 
graphical development environ- 
ment. Features include windows 
painter, source code management, 
and debugging tools. Price: 
$4,000.00. 


ASIAN OS/2 





ea 





with purchase of 







= 


Circle Reader Service Number 35 


DEVELOPER SUPPORT 


PEOPLE'S 
REPUBLIC OF 


Get help porting OS/2 applications for 
Japanese, Chinese, or Korean. 


dbfREXX 
FREE 


dbfLiB! 
Limited time 


Experienced guidance from the leading 
double byte character set OS/2 developer. 
Training or consulting on either an hourly or 


long term basis. 


Circle Reader Service Number 36 





(301) 330-2995 
Fax:(301) 330-8609 
CompuServe: 70334,3616 
Internet: 70334.3616 @ 
COMPUSERVE.COM. 


AicroBurst, Inc. 


9035 Shady Grove Court 
Gaithersburg, MD 20877 


dSOFT Development Inc. 
4710 Innsbruk Drive 
Houston, TX 77066 
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GURU 3.1 is a development envi- 
ronment and relational database 
management system that offers 
information-processing _ tools. 
Within GURU, the user can access 
features such as a spreadsheet, busi- 
ness graphics, text processing, report 
generation, communications, and a 
language interface. GURU is com- 
patible with SQL. It supports for- 
ward chaining, backward chaining, 
mixed chaining, multivalue vari- 
ables, and fuzzy reasoning. Price: 
$7,000.00. 

Knowledge Man 3.1 combines a 
relational database management sys- 
tem and a fourth-generation lan- 
guage with a set of decision support 
tools. It includes KGL, an object- 
based, fourth-generation language 
and a KGL compiler. Binary large 
objects enable the user to store dif- 
ferent types of information, includ- 
ing sounds and images, in variable- 
length records that the user can 
access with SQL queries. Price: 
$1,500.00. 

Micro Data Base Systems Inc., 
1305 Cumberland Ave., P.O. Box 
2438, West Lafayette, Ind. 47906, 
(800) 445-6327 or (317) 463-7200, fax 
(317) 463-1234. 


MICRO FOCUS Circle No. 118 
Micro Focus COBOL 3.2 contains a PC 
COBOL compiler and an interactive 
code debugger (Animator). Micro 
Focus has added 75 enhancements to 
this updated version, ranging from 
new syntax and increased perfor- 
mance to improved run-time man- 
agement and usability enhance- 
ments. Price: $750.00. 

Micro Focus COBOL Workbench 3.2 
is a suite of programmer productiv- 
ity tools that allows the user to 
develop and maintain applications. 
Micro Focus COBOL Workbench 
includes Micro Focus COBOL 
Compiler, Micro Focus Toolset, and 
Micro Focus Operating System 
Extensions (OSX). Price: $2,500.00. 





Micro Focus, 2465 E. Bay Shore 
Rd., Palo Alto, Calif. 94303, (800) 
872-6265 or (415) 856-4161, fax (415) 
856-6134. 


MICROWAY INC. Circle No. 119 
NDP Pascal 4.4 for OS/2 implements 
the ANSI/IEEE standard 770X3.97- 
1983, a superset of Niklaus Wirth’s 
Pascal. It includes several extensions 
from Berkeley 4.2 BSD Pascal and 
the British Standards Institute Level 
0, a preprocessor, separate compila- 
tion of modules, and interfaces to 
the Microway C library. Price: 
$595.00. 

NDP C/C++ 4.4 for OS/2 is an 
AT&T 2.1-compatible compiler that 
includes NDP C, a dual-dialect com- 
piler that supports two UNIX 
dialects (BSD 4.2 and AT&T 2.1), and 
the new ANSI C specifications. It 
features a function inliner, classes, 
single and multiple inheritance, con- 
structors and destructors, and func- 
tions and operator overloading. 
Price: $595. 

NDP Fortran 4.4 for OS/2 offers 
standard global optimizations per- 
formed by a number of C compilers. 
It provides coprocessor support for 
the Weitek 3167/4167 and the Intel 
i860 and optimizations for the 
Pentium and 387/487 relating to 
storage allocation and inline execu- 
tion of intrinsic functions. NDP 
Fortran is an F77 with VMS, VS, and 
MS extensions. It is compatible with 
the IBM C Set compiler, Toolkit, and 
WorkFrame. Price: $595.00. 

Microway Inc., Research Park, 
Box 79, Kingston, Mass. 02364, (508) 
746-7341, fax (508) 746-4678. 


PARCPLACE 

SYSTEMS INC. Circle No. 120 
ObjectWorks Smalltalk is an object- 
oriented development environment 
for the development and delivery of 
color graphic applications in a het- 
erogeneous computing environment. 
ObjectWorks includes Smalltalk lan- 
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guage, a set of integrated designed- 
for-objects development tools and a 
mature class library of over 400 
types of portable objects. Price: 
$2,495.00. 

ParcPlace Systems, Inc. 99 E. 
Argues Ave., Sunnyvale, Calif., 
94086, (408) 481-9090, fax (408) 481- 
9095, 


PROMULA DEVELOPMENT 

CORP. Circle No. 121 
Promula Fortran to Fortran Translator 
5.02 transforms’ unstructured 
spaghetti Fortran code into well- 
structured Fortran code. It aids in 
cleaning up and upgrading old 
Fortran code. The translator sup- 
ports most known Fortran dialects- 
standard or extended-including 
most Fortran 90 features. Price: 
$1,500. 

Promula Fortran to C Translator 
5.02 is a portation tool that converts 
Fortran source code to C source 
code. It supports the Fortran 66 and 
Fortran 77 standards and many 
extended dialects (VAX, IBM, 
PRIME, SUN FORTRAN, and so on), 
including most Fortran 90 features. 
The C code it produces is portable 
and readable (maintainable). Price: 
$1,500.00. 

Promula Fortran to C++ Translator 
5.02 converts FORTRAN code to C++ 
code. It supports standard Fortran 
66, Fortran 77 and many extended 
dialects (VAX, SUN, PRIME, IBM 
VS), and most Fortran features. It 
produces C++ code that is readable 
and integrates with contemporary 
C++ OS/2 platforms—IBM C Set, 
Borland, Watcom, MetaWare, and 
Zortech. Price: $1,500.00. 

Promula Fortran Compiler 5.02 sup- 
ports the Fortran 66 and Fortran 77 
standards and many extended 
dialects (VAX, IBM, PRIME, SUN 
FORTRAN, and so on), including 
most Fortran 90 features. It compiles 
Fortran to C and is integrated with 
several OS/2 C/C++ compilers— 


Watcom, Borland, Zortech, Meta- 
Ware, and IBM C Set. Price: $1,000.00. 

Promula Development Corp., 
3620 N. High St., Ste. 301, Columbus, 
Ohio 43214, (614) 263-5454, fax (614) 
263-5573. 


QUERCUS 
SYSTEMS Circle No. 122 
Personal REXX 3.0 for OS/2 augments 
OS/2 REXX by including Quercus 
Systems’ REXXLIB extensions for 
array handling, mathematical func- 
tions, interprocess communication, 
and general system services. In addi- 
tion, it provides global variables; 
utilities for VM/CMS and VMS/ 
TSO compatibility; and external data 
queue support. A variety of perfor- 
mance enhancements improve Per- 
sonal REXX’s speed. Price: $175.00. 
Quercus Systems, P.O. Box 2157, 
Saratoga, Calif. 95070, (408) 867- 
7399, fax (408) 867-7489. 


REUSABLE 

SOLUTIONS INC. Circle No. 123 
Facets/4GL 3.0 is an object-oriented, 
fourth-generation language. This 
library of classes adds a collection of 
design tools to the Object- 
works/Smalltalk development sys- 
tem. Through a series of on-screen 
forms, FACETS allows the user to 
generate screens, reports, menus, 
and other interface components. 
FACETS/4GL consists of five design 
tools: a schema designer, a forms 
designer, a report writer, a menu 
builder, and a help author. Price: 
$2,000.00. 

Reusable Solutions Inc., 1130 
SW Morrison, #318, Portland, Oreg. 
97205, (503) 223-6892, fax (503) 223- 
4498. 


SCIENCIA LTD. Circle No. 124 
Procyon Common Lisp 3.3.4 is an object- 
oriented development environment 
based upon Common Lisp and 
CLOS. Users can port applications 
to OS/2, Windows, and Macintosh 


without code changes. Procyon is 
royalty-free. Price: $1,800.00. 

Scientia Ltd., St. John’s 
Innovation Centre, Cowley Rd., 
Cambridge U.K., +44-223-42128, fax 
+44-223-42128. 


TOWER TECHNOLOGY 

CORP. Circle No. 125 
TowerEiffel 1.3 is an object-oriented 
programming system that includes 
an Eiffel 3 compiler, a development 
environment, programming tools, 
and a set of reusable software com- 
ponents. The TowerEiffel compiler 
provides support for multilanguage 
development and interoperability 
between Eiffel, C, and C++. Price: 
$1,295.00 for commercial license; 
$295.00 for students. 

Tower Technology Corp., 1501 
Koenig Ln., Austin, Tex. 78756, (800) 
285-5124 or (512) 452-9455, fax (512) 
452-1721. 


2500AD 
SOFTWARE INC. Circle No. 126 
2500AD € Compiler has floating-point 
math, inline assembly language, 
ROM-able code, and memory bank- 
switching. The C Compiler includes 
an assembler, linker, librarian, macro 
preprocessor, simulator /debugger 
(if available), and object libraries. 
Full technical support and a 90-day 
money-back guarantee are included 
in the purchase price. Price: $650.00, 
most versions. 

2500AD Software Inc., 109 
Brookdale Ave., Buena Vista, Colo. 
81211, (800) 843-8144 or (719) 395- 
8683, fax (719) 395-8206. 


VZ CORP. Circle No. 127 
VZ Programmer 2.3 is a programming 
environment that extends the func- 
tion of the application by adding 
C++ code to any object in an object- 
oriented environment. This is a non- 
limiting programming environment 
that allows the programming of any- 
thing that can normally be pro- 
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grammed using C++. Price: $2,000.00. 

VZ Corp., 175 S. Main St., Ste. 
700, Salt Lake City, Utah 84111, (800) 
377-1090, (801) 595-1352, fax (801) 
328-4404. 


WATCOM INTERNATIONAL 
CORP. Circle No. 128 
Watcom C/C++ 10.0 is a C and C++ 
development system for DOS, 
Windows NT, Win32, OS/2 2.x, 
Novell NLS, and 16-bit DOS and 
Windows 3.x. It combines a compiler 
technology with a development 
environment and set of tools. Wat- 
com C/C++ includes a GUI debug- 
ger, a C++ class browser, and a pro- 
filer. It provides support for C++ 
templates, exception handling, and 
Microsoft Foundation Class libraries. 
Price: Please contact vendor. 
Watcom International Corp., 415 
Phillip St., Waterloo, Ont. N2L 3X2, 
Canada, (800) 265-4555 or (519) 747- 
4971, fax (519) 747-4971. 


XVT 
SOFTWARE INC. Circle No. 129 
XVT Development Solution for C (DSC) 
4.0 pairs XVT-Design, a visual GUI 
layout, prototyping and code-gener- 
ation tool, with the XVT Portability 
Toolkit, a thin-layered API that pro- 
vides native look-and-feel and sin- 
gle-source portability to seven differ- 
ent GUIs and over 30 hardware 
platforms. Price: $1,950.00-$6,300.00. 

XVT Development Solution for C++ 
(DSC++) 2.0 features XVT-Power++, 
an applications framework with fea- 
tures such as field validation, drag- 
and-drop, environment inheritance, 
nested views, geometry manage- 
ment, imaging, and the Rogue Wave 
data structures. Combined with the 
XVT Portability Toolkit, XVT- 
Power++ offers portability to many 
GUIs. Price: $1,950.00-$6,300.00. 

XVT Software Inc., 4900 Pearl 
E. Cr., Boulder, Colo. 80301, (800) 
678-7988 or (303) 443-4223, fax (303) 
443-0969. 





oN 





WE GOVER 05/2 


for Developers... 


OS/2 2.1 WORKPLACE 
SHELL PROGRAMMING 


Steve Maruzzi 

“If C++ and Work-place Shell are in your 
career path, this book/software package 
should be in your hands.”—OS/2 Professional 
Packed with high-end tips and techniques, 
OS/2 2.1 Workplace Shell Programming 
offers a programmer's insight into OS/2 | 
application development and shows C programmers how to imple- 
ment a full OS/2 interface. A leading authority on OS/2, Maruzzi 

| guides you through the process of building outstanding applications 
| and interfaces with examples throughout the text and source code 
supplied on the accompanying disk. You'll get the low down on * the 
OS/2? system architecture * memory management * the graphics 
display interface * and much more. $44, 744 pages, 0-679-79162-0 


for Novices... 


VAN WOLVERTON’S GUIDE 
TO OS/2, VERSION 2.1 


| Van Wolverton and Jim Meade 












































A critically acclaimed handbook and 
indispensable guide to OS/2 for begin- 
ners as well as for intermediate users 
who want to explore its latest features. Perfect for anyone who 
needs ® straightforward, nontechnical explanations * a concise 
guide to OS/2 basics * and quick steps for running multiple appli- 
cations. $16, 144 pages, 0-6 79-745 77-6 





DVORAK’S GUIDE TO 
| OS/2, VERSION 2.1 
John C. Dvorak, David B. Whittle, 

and Matin McElroy 

“A serious, detailed, dedicated study of 
OS/2 by authors who know the deepest 
secrets of a massive and powerful operating 
system." —PC' Magazine 


Dvorak’s Guide to OS/2, Version 2.118 a 
complete command reference that thoroughly explains al all OS/2 
commands. An extensive tips and tricks section will turn you into a 
power user. The authors provide important resources to help you 
solve any problem, plus a complete listing of worldwide OS/2 

| computerized bulletin boards. $45, 816 pages, 0-679-74645-X 


LOOK FOR THEM IN THE COMPUTER 64@1R 
SECTION OF YOUR LOCAL BOOKSTORE. ewomus 
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CLIENT/SERVER SURVIVAL GUIDE WITH 
OS/2 2.1 by Robert Orfali and Dan Harkey. 

A sweeping tour of client/server systems and 
software. $39.95 0442-01798-7 IBM# SR28-5494 


CLIENT/SERVER PROGRAMMING WITH 
OS/2 2.1, 3rd Ed., by Robert Orfali and 
Daniel Harkey. “Absolutely one of the most 
impressive, useful, best-written computer 
books Ive ever seen.’—Will Zachman. 
$39.95 0442-01833-9 IBM# G325-0650-02 


THE GUI-OOUI WAR: Windows vs. OS/2 

by Theo S. Mandel. “A book that should be 
forced on every Windows and OS/2 developer 
working today. An exceptionally clear, read- 
able quide. If you want to make a good 
program great, there’s no better starting 
place.’—OS/2 Professional 

$29.95 0442-01750-2 IBM# SR28-5251 


OS/2 FUNCTIONS QUICK REFERENCE 
LIBRARY 1: Win Functions by Nora 
Scholin. $19.95 0442-01897-5 


C AND C++ PROGRAMMING IN THE OS/2 
ENVIRONMENT by Mitra Gopaul. 539.95 
0-442-01240-3 IBM# SR28-4404 


OS/2 2.1 APPLICATION PROGRAMMER'’S 
GUIDE by Jody Kelly, Craig Swearingen, 
Dawn Bezviner and Theodore Shrader. 
$34.95 0442-01736-7 IBM# SR28-5449 


OS/2 2.1 REXX HANDBOOK: Basics, 
Applications, and Tips by Hallet German. 
A great reference book that contains info 
not found in any other REXX books. 

$29.95 0-442-01734-0 IBM# SR-5250 
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Windows vs. OS/2 


The Designer's Guide to 
Human-Computer Interfaces 





THE OS/2 2.1 CORPORATE PROGRAM- 
MER’S HANDBOOK bi Nora Scholin, Mark 
Sullivan, and Robin Scragg. “A solid job. 
Introduces readers to programming terms 
and concepts. Explanations are lucid and 
reading relevant sections provides you with 
the basics you need.”—OS/2 Professional. 
Includes disk. $39.95 0442-015954 

IBM# SR284390 


WRITING OS/2 2.1 DEVICE DRIVERS IN C, 
2nd Ed., by Steven Mastrianni. “Should give 
any C programmer with a vague knowledge 


of OS and PC hardware a headstart in writ- 


ing OS device drivers in C.”"—International 
OS/2 User Group Magazine. Includes disk. 
$39.95 0-442-017294 IBM# SR28-4392 


THE SHELL COLLECTION: OS/2 2.X 
Utilities by Steven Levenson. A great source 
of shortcuts, tips and productivity boosters 


for Windows and DOS. Includes disk. 


$29.95 0442-01585-2 IBM# G362-0049 


USING WORKPLACE OS/2: Power User’s 
Guide to IBM OS/2 Version 2.1 by Lori 
Brown and Jeff Howard. The authors are the 
principal designers of the Workplace Shell! 
Includes disk. $24.95 0-442-01590-9 

IBM# SR284391 


THE OS/2 2.0 HANDBOOK: Applications, 
Integration, and Optimization hy William 
H. Zack. “Should be within fingertip reach of 
anyone working with OS2. IBM would do 
well to include a copy tn every package of 
OS?."—OS? Professional $34.95 0442-01284-9 
IBM# G362-0009 


ree wee . 
OS/2" bs a registered trademark of the [IBM Corporation 
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OS/2 2.X NOTEBOOK: The Best of IBM 
OS/2 Developer, edited by Dick Conklin. 
$36.95 0442-01522-4 IBM# G362-0015 


NOW THAT I HAVE OS/2 2.1 ON MY 
COMPUTER, WHAT DO I DO NEXT?, 2/E. 
by Steven Levenson. “Easy to read, loaded 
with examples, a friendly reference source.” 
—Journal of The Chicago Computing Society. 
$22.95 0442-01832-0 IBM# G362-0008-01 


COMPREHENSIVE DATABASE PERFOR- 
MANCE FOR OS/2 2.0’s Extended Services 
by Bruce Tate, Tim Malkemus and Terry 
Gray. $41.95 0442-01325-6 IBM# G362-0019 


LEARNING TO PROGRAM OS/2 2.0 
PRESENTATION MANAGER BY EXAMPLE: 
Putting the Pieces Together 

by Stephen Knight. Includes disk. 

$41.95 0442-01292-6 IBM# G362-0011 


THE COBOL PRESENTATION MANAGER 
PROGRAMMING GUIDE by David M. Dill. 
$41.95 0442-01293-4 IBM# G362-0010 


OS/2 PRESENTATION MANAGER GPI 
GRAPHICS by Graham C. E. Winn $42.95 
0-442-00739-6 IBM# G362-0005 


Order directly from 
the publisher by call- 
ing 1-800-544-0550. 
To order from IBM 
call 1-800-568-2694 


| Van Nostrand Reinhold 


115 Fifth Avenue, New York, New York 10003 





1-800-544-0550 73373.64 @compuserve.com 
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New Tools for OS/2 


Techbridge Builder. This GUI, 
client/server / object-oriented ap- 
plication development environment for the 
IBM OS/2 operating system allows anyone, 
from experienced users to professional devel- 
opers, to create sophisticated workplace 
applications involving drag-and-drop opera- 
tions and enterprise-wide database access in 
object-oriented manner. Developers using 
TechBridge Builder simply paint the majority 
of an application into existence with visual 
programming tools and code the rest in stan- 
dard COBOL or SOL. 

For the advanced developer, TechBridge 
Builder provides object-oriented extensions 
to the COBOL language support. 





TechBridge Technology Corp. 
Phone: (416) 222-8998, Fax (416) 222-0168 


XDB-Server 4.0. XDB-Server 4.0 provides 
enhanced server functionality for distributed 
client/server environments through a rich set 
of development tools, including optimized 
query performance, server-to-server connec- 
tivity, and administration tools. XDB-Server 
4.0 achieves faster response times through 
performance-tuning options, allowing the 
user to fine-tune the database server. Users 
also have the flexibility of remotely accessing 
data while not robbing the enterprise of con- 
sistent system administration. Database 
administrators and developers familiar with 
DB2 3.1 can develop and target applications 
on a client/server LAN using XDB-Server 4.0. 
Of particular note to OS/2 users, XDB-Server 
4.0 has a 32-bit, multithreaded architecture. 


XDB Systems Inc. 
Phone: (301) 317-6800 ext. 146, 
Fax: (301) 317-7701 


dbfREXX 1.0. This DLL for OS/2 2.1 extends 
the built-in REXX language with commands 
for manipulating dBase files, including DBF, 
DBT, and NDX. According to the company, 
REXX users will be able to tap into simple 
database management without all the over- 
head of a full-blown client/server DBMS. 


dSOFT Development Inc. 
Phone: (405) 360-3045 or (713) 537-0318 


Watcom SQL. Watcom SQL network servers 
for OS/2, which are available in single-user 
and multiuser versions, benefit from the 
advantages of the 32-bit OS/2 platform and 
exploit multitasking capabilities to run con- 
currently with other applications, eliminating 
the need for a dedicated database server. 
Watcom SQL uses the Open Database Con- 
nectivity standard for SQL database connec- 
tivity as its functional API, providing inter- 
operability with a range of front-end tools. It 
also offers application programming features 
such as bidirectional, scrollable, updatable 
cursors; updatable multitable views; binary 
large objects; self-tuning, cost-based query 
optimization; database compression; and 
multinational character set support. 


Watcom International 
Phone: (519) 886-3700 


UNIFACE. The company has announced the 
availability of UNIFACE tools that are opti- 
mized for IBM’s DB2/2 and DB2/6000 rela- 
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tional database management systems. A new 
interface links the UNIFACE development 
system with DB2/2, DB2/6000, and host- 
based servers. The interface aims to provide 
transparent and simultaneous read/write 
access to DB2/6000 databases under AIX and 
DB2/2 databases under OS/2 and will sup- 
port host-based DB2 security, error handling, 
data integrity and recoverability, and all DB2 
data types. UNIFACE applications are 
designed to access many relational and non- 
relational data sources, including DB2/2, 
Rdb, INGRES, ORACLE, Sybase, and 
Microsoft SQL server. 


Uniface Corp. 
Phone: (510) 748-6025 


ESL Workbench 4.0. This OS/2-based integrat- 
ed development environment enables devel- 
opers to rapidly create simultaneous mulTti- 
ple-language client/server applications. New 
CUA extensions have been added, including 
spin button, slider control, and drag and drop 
to enhance graphical user interface develop- 
ment. Integration with Intersolv’s PVCS mul- 
tideveloper support allows teams of develop- 
ers to simultaneously work on an application 
by version control and creation of archive 
files. ESL Workbench 4.0 also features the 
ESL Wizard, a visual programming tool that 
provides reusable code libraries and dynamic 
code generation. 


Easel Corp. 
Phone: (617) 221-2100, Fax: (617) 221-3099 


AlertVIEW. The company has announced 
AlertVIEW for Lotus Notes, which is in- 
stalled on OS/2 Lotus Notes servers to report 
replication, server, security, statistics, mail, 
and communication events. This agent 
detects errors that are not reported in the 
standard error log and also reports errors 
from remote Notes servers connected using 
dial-up services. 
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Shany Inc. 
Phone: (415) 694-7410, Fax: (415) 694-4728 


AutoTester 2.0. Just released for the OS/2 Pre- 
sentation Manager operating system, Auto- 
Tester 2.0 is a testing and verification tool for 
graphical user interface applications. The 
software provides word-processing type edit- 
ing of tests, including familiar features such 
as cut/copy/paste, find/replace, and ad- 
justable fonts. The primary focus of the Auto- 
Tester 2.0 release is the introduction of Auto- 
Command, which generates a documented 
automated test instead of recording only a 
series of keystrokes and mouse events. 


AutoTester Inc. 
Phone: (800) 328-1196 or (214) 368-1196 


Subpanes/v. The company has added 20 new 
controls to this library of controls for 
Smalltalk/V and WindowBuilder Pro/V. The 
new controls include columnar list box, Table 
Pane, Bitmap Pane, Bitmap Button, Sliders, 
Gauges, 3-D Frames, HierarchicalListBox, 
DateEditor, TimeEditor, and NumberEditor. 


Objectshare Systems Inc. 
Phone: (408) 970-7280, Fax: (408) 970-7282 
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(I-r) Brian Norquist, Rolando Arquiza, 
Larry Gavin, Jerry Bayer 


hey said it couldn't be done. 
“Impossible!” “Not in our trading 


pits.” But they were wrong. For 
well over a year now, a number of floor 
brokers in Chicago have been using 
OS/2 with pen based technology, right 
in the heart of the Chicago Mercantile 
Exchange’s (CME) future trading pits. 


CHICAGO'S CUBS 

The system the brokers are using is 
called CUBS, the CME Universal Broker 
Station. This system, in conjunction with 
its front-end processor, allows firms 
located around the world to route or- 
ders directly to brokers 
in the pit. The system 
also provides the broker 
with deck management, 
execution, and endorse- 
ment capabilities that 
instantly inform the firm 
whenever a trade has 
taken place. Compared 
to the current manual 
system, CUBS offers a 
number of advantages as it takes recent 
computing technology where it has 
never gone before—the pits. 





LIFE IN THE PITS 
It was easy, however, to see why the 
skeptics felt the way they did; the 





louch-screen technology has made it possible to deploy automation where it was previously thought 
impossible. Doing so has required some rethinking of the user interface. To enhance usability, speed and 
ease of use were given paramount consideration. But it all relies upon hardware to provide an intuitive 
pen or touch “feel.” By the CUBS TEAM—ROLANDO ARQUIZA, JERRY BA YER, LARRY GAVIN, BRIAN 
NORQUIST, AND JIM ZEIDEL 


OS /2 Survives the Pits! 


Chicago-styled open outcry method of 
trading is very physically and mentally 
demanding. If you have not seen these 
trading pits on television or in the 
movies, it may be difficult to imagine 
what it’s like. 

Picture yourself in a jam-packed 
elevator, shoulder to shoulder, chest to 
back with people. Add the element of 
chaotic market swings, where fortunes 
can be made or lost in a matter of min- 
utes. And remember that you are in 
direct competition with everyone 
around you in getting off your order. 
That means being seen and heard first. 
You have to stay alert and act fast— 
very fast. 

This is the “major league” of trad- 
ing. On some days, the Chicago Mer- 
cantile Exchange executes over two 
million contracts. That represents over 
two trillion dollars in underlying con- 
tract value. That’s more than the entire 
U.S. government budget for a year 
changing hands in a single day! This is 
how worldwide businesses insure 
themselves against market risk. This is 
where the business world turns to 
secure some stability for decision mak- 
ing. And at this level, you can be sure 
CME impacts your life in untold ways, 
even if you have never heard of 
futures. 
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INTRODUCING OS/2 PEN TECHNOLOGY 

It is in this environment that OS/2 with 
touch-screen technology has found a 
home. Why? Because this technology 
can stay alert and act very fast. This 
technology is the preemptive design of 
OS/2 coupled with its multitasking / 
multithreading capabilities. All of which 
is presented to the user via a natural- 
feeling, responsive touch screen. Ob- 
viously, the traditional keyboard and 
mouse cannot be used effectively in this 
environment. Without pen technology, 
this application would never have been 
conceived. 

It’s that high-pressured, time-criti- 
cal, physically draining environment 
that demands an application that is intu- 
itive to use—right down to the feel of 
the pen on the screen. Anything less 
would be technology hindering, not 
helping, the broker. 

For example, a lesser operating sys- 
tem might pause momentarily while 
simultaneously: 

* Receiving orders from as many as 80 
firms 

¢ Updating the window of open orders 

* Displaying a continuous stream of 
market quotes 

¢ Printing an endorsement ticket. 

If a pause occurs as the broker tries 
to register a trade, the broker may try 
again, entering a second double-click. 
So when the system returns to process 
the user input queue, it might actually 
kick off two trades. This would cause 
confusion at the worst possible time— 
when the broker is most busy. At the 
very least, it might require the broker 
to wait, distracting the broker’s atten- 
tion. All of this is unacceptable: the 
broker's livelihood depends on paying 
complete attention to the trading pit, 
not on wrestling with some piece of 
equipment. 

CUBS avoids these pitfalls. Using 
OS/2’s preemptive operating system, 
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user input is given highest priority, re- 
turning the necessary visual feedback 
immediately, while the other multi- 
threaded tasks are efficiently completed 
simultaneously. 


IT'S PERFECT! 

The results speak for themselves. 
According to Ed Zegar, vice president of 
GSA and one of CME’s CUBS brokers, 
“Its perfect!” But to get that kind of re- 
sponse from our users required not only 
OS/2 and IBM’s touch screens but also a 
close working relationship with users in 
order to fine-tune the application. 


AN ENDORSEMENT FOR HANDWRITING 

At first the system was designed so that 
push buttons were used for everything. 
But during mock trading sessions, we 
soon found that—surprise!—the traders 
were accustomed to using a pen as a 
pen, not just as a pointing device. They 
wanted to write out their endorsements, 
not use push buttons. An endorsement 
consists of: 

¢ The actual execution price 

¢ The opposite broker(s) 

¢ The opposite broker’s house 

¢ Some other information. 

However, a push-button approach 
does not duplicate the nuances of written 
endorsements. Every written endorse- 
ment is slightly different. Thus, if a broker 





A broker's CUBS screen used in the pits 
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is interrupted in the middle of writ- 


ing an endorsement—say, to exe- (7 BUTTON DOWN CODE 

cute a trade—the broker could look | PFMWP buttonProc = NULL; 

at the first stroke on the screen and inland LLL Let eT TTT TTT TTT TT TTT CTT TTT TTT TTT Treen 
recall the transaction along with | * 

related information. 

Looking at nicely printed text 
generated from pushed buttons 
does not invoke the same level of 
recall. One transaction looks simi- 
lar to another. This recall capability —§ 4 





“gal et RegisterButtonDwnClass 

he function registers a window class that is a subclasses of the 
WC_BUTTON window proc. It changes the buttons response to 
WM_BUTTONIDOWN and WM_BUTTONIUP. It changes the button proc to 


produce a WM_COMMAND on the location of WM BUTTONIDOWN 
WM_BUTTONAUP. , i 


“t+ # & & 


is I ) . : 
mportant since it allows brokers — ¢ FEEEE EERE EERE EERE ERE EERIE AT AAR ERA AAA TATA AIA SA SAA ot eet | 


to be interrupted many times and | BOOL EXPENTRY RegisterButtonDwnClass( HAB hab ) 
to queue endorsements in their | { 


heads while more immediate tasks CLASSINFO classinfo; 

are addressed. The ability to do if ( buttonProc == NULL ) 

this lets brokers act very fast when { 

trading. if WinQueryClassInfo( hab, (PSZ) WC_BUTTON, &classinfo ) ) 
THE NATURAL WAY buttonProc = classinfo.pfnWindowProc; 


Capturing handwriting is more Classinfo.flClassStyle &= ~CS_PUBLIC; 


like the way brokers have been 
doing their jobs for years. It works, Figure 1. Button down code (continued on page 88) 
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myths about client/server testing. 





Myth #1: Client/Server testing is easy. 
New development tools make building client/ 









server applications easier than ever. The problem ’ 

is, they're harder to test, and you just can't stand Quadron’s OS/2 Co pair 
up to them with manual testing methods. You development tools 

need ATF, the only testing product designed for team up with IBM 


ARTIC co-processor cards to give you flexibility, 
communication power, and development speed. 


client/server. 


Myth # 2: Client/Server testing is impossible. 
Testing client/server applications can be daunting. 







Use Quadron software and ARTIC tasks on the card. Then check it 
cards to gain extra ports and out with our symbolic debugger 
enhance host PC per- and real-time analysis tools in 
formance by moving OS/2 windows. 

protocol processing to Our easy-to-use software 
the cards. Develop serves applications as diverse as 
standard and custom telephone switching, financial 
communications for transactions, satellite commu- 
async, BISYNC, HDLC, nications, and process control. If 
X.25, LAP-B, or your own special any of this sounds like a match for 
protocol. And if you need more your needs, call us today. 

than one protocol, no problem— am 


just run them at the same time on Quadron 
am 


the same card. 
Programmers feel right at home 209 East Victoria Street 
Santa Barbara, CA 93101 


with our software. Just program in ae 
standard C, and use our messag- Vet Fax: 805-966-7630 
ing API to link OS/2 threads with _* * 805-966-6424 






The problem is, your tests need to replicate real- 
world conditions, and you just can't do that with a 
stand-alone testing product. You need ATF, the 
only testing product designed for client/server. 














The Softbridge Automated Test Facility's unique 
architecture makes it the only product for true 
client/server testing of OS/2 and Windows apps. 
To learn more about ATF, call 617-576-2257. 
(Or FAX 617-864-7747.) 


lf you're coming to OS/2 World in Santa Clara 
this July, stop by Booth 615 for an ATF demo. 
There's only one way to test client/server 
applications, and that's with ATF. 












LA) Softbridge, Inc. a 125 CambridgeParkDrive a Cambridge, MA 02140 Trademarks are the property of their respective owners. 
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and they want to keep doing it that 
way. Technology should serve the 
user, not the other way around. So, 
we changed the application to cap- 
ture their handwriting. The bro- 
kers love it. 


IT’S GOTTA BE COLOR 

Color also plays a large role. At 
first, only black and white screens 
were used. They worked, but as 
soon as the brokers saw the color 
units, they no longer wanted the 
black and white screens. Color 
gives important visual feedback. 
The user does not have to read 
words on the screen. Blue means a 
buy order, and red means a sell 
order. Brokers do not have to read 
the words to know what side of 
the market they are on. This saves 
time when they are entering and 
filling orders. 


- MAY THE . -- 
" SOURCE - 
- BE WITH” 


ioe (2 ee 


Don't let the dark forces of ignorance 
defeat you. Tap intothe freeCONSUMER . 
INFORMATION CATALOG -- the source for 
more than 200 free and low-cost 
# government publications on cosmic 
topics such as health, travel, nutrition, 
careers and government benefits. Just 
send your name and address to: 


Consumer Information Center 
« Department Source : 


. 
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'* Pueblo, Colorado 81009 —s- 


On the black and white units, 
this critical distinction is not as 
obvious. Color, therefore, lets bro- 
kers act quickly and avoid costly 
mistakes. 


LET YOUR FINGERS DO THE TRADING 
On some of the candidate touch 
screens, a unique and dedicated 
pen was required. Brokers could 
not use those systems if they lost 
their pens or if their pens stopped 
working for some reason. To guard 
against this, the units deployed are 
both pen- and finger-sensitive. If 
brokers lose their pens, they can 
use their fingers. (Sometimes in the 
pits, brokers have to be careful 
about losing fingers as well!) 


MAKE THOSE BUTTONS BIG! 
One important aspect of the user 
interface was the size of the but- 


tons; they had to be large enough 
for a gorilla’s finger! Although 
this eats up valuable screen geog- 
raphy, it has the advantage of 
providing a large landing area. 
Users appreciate this even when 
they are using a pen. 

To make it even easier to use 
the touch screen—especially when 
brokers are being jostled around 
during fast markets—the buttons 
had to be subclassed to register a 
touchdown even though the bro- 
ker’s pen or finger slid off before it 
was picked up. This is not stan- 
dard CUA protocol, but in this 
environment, it’s what works. 
Figures 1 and 2 show how that 
subclassing was done. 


BUTTONS FOR BARS 
To further the idea of large, easy- 
to-hit touch areas, we used a row 
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Talegeleltlalate me yeir-liie-li ace Zell lme)gel- lal pe: a lola ka 


Travel with the team that knows the way... 
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“Your Smalltalk Experts” 


AT 
a ' 


Education & Training 


. Smalltalk for Cobol Programme 
* VisualAge 

¢ ENVY/Developer 

* Analysis & Design 

* Project Management 

* |n-House & Open Courses 


" s, OS2, Mia -\ 





* Custom Software Development 
Legacy Systems 
GUI's, Databases. 
Client-Server 


The Object People Inc, 509-885 Meadowlands Dr., Ottawa, Ontario, K2C 3N2 
Telephone: (613) 225-8812 FAX: (613) 225-5943 


Smalltalk/V is a registered trademark of Digitalk, Inc. 
VisualWorks is a trademark of ParcPlace Systems inc. 


VisualAge is a registered trademark of IBM. 
ENVY is a registered trademark of OT! Inc. 
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of buttons painted across the top 
of the windows to support vari- 
ous activities instead of the stan- 
dard action bar. Instead of the 
standard action pull down menu, 
a column of easy-to-hit buttons 
appears. Figure 2 shows how we 
did this. 


OTHER THINGS 

LEARNED ALONG THE WAY 

During the mock training sessions, 
we were surprised to learn that 
some people have a difficult time 
double-clicking with a pen. Others 
seem to do it naturally. So the sys- 
tem was designed to have large 
“buy” or “sell” buttons on it for 
those who would prefer the one- 
button, one-click approach. 


HAVE IT YOUR WAY 
We used command-line parame- 
ters for situations that do not 
change dynamically and user- 
definable buttons for those situa- 
tions that do. For example, our 
keypad has user-definable but- 
tons for quantities; touching a 1 
and then a 0 button is not as fast 
as a single touch of a 10 button. 
Later, when brokers are trading 
25 lots more often, we can reset 
that user-definable button to 25 
on the fly. 

In another example, our 
numeric keypad has a command- 
line parameter for left- or right- 


Figure 1. Button down code (continued from page 86) 


Figure 2. Button menu code (continued on page 89) 
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2. Button menu code (continued on page 90) 
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Figure 2. Button down code (continued on page 91) 
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Figure 2. Button down code (con tinued from page 90) 
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handed orientation. One person 
wants the numbers like a tele- 
phone pad with 1-2-3 at the top, 
another wants the opposite. 

Another important aspect 
about designing this touch-screen 
application was that keystrokes 
had to be minimized at every 
opportunity. Every time the broker 
has to touch a button or write on 
the screen, the broker’s eyes would 
be diverted from the pit. We did 
not want this. So, we built in 
defaulted assumptions wherever 
possible. 

When it comes to touch-screen 
applications, programmers have to 
be prepared for supporting all 
kinds of user-to-user requirements. 
They have to be flexible. That flexi- 
bility must be built right into the 
application. 


SPEED KILLS? 

Speed is always essential, so the 
buttons in an activity have to be 
grouped close together. The bro- 
ker’s hand must not fly all over the 
screen. 

For example, sometimes a bro- 
ker is in the act of writing out an 
endorsement in one window and 
receives an incoming order in 





another window. The problem is 
that the “accept” button is on the 
far side of the screen. Although 
this is where the broker usually 
wants it, in times like these the 
broker also wants another “accept” 
button nearby to save time. 


GIVE ‘EM WHAT THEY 

WANT WHEN THEY NEED IT 

You cannot expect users to be com- 
puter literate. You cannot expect 
them to know how to size a win- 
dow or how use the title bar. If a 
window was expanded to take up 
the whole screen, the user could 
become confused. So we changed 
the windows so that the title bar is 
hidden unless it is specifically 
requested. It is embedded in the 
application in a turnkey way. 
Figure 3 shows that we concealed 
the frame controls. 


IN CONCLUSION 

Touch screen technology has 
opened up new areas for previ- 
ously untapped automation. This 
technology can be successful in 
environments few thought pos- 
sible. As you work to build the 
infrastructure for a better tomor- 
row, we hope our experiences and 





Figure 3. Hide title bar and frame controls (continued on page 93) 
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coding examples may be of some 
assistance. Have fun! 


Rolando Arquiza, senior programmer 
analyst, joined the CUBS team recently. 
His formidable background in Windows 
and OS/2 enable him to make significant 
contributions to the CUBS systems. 


Jerry Bayer, senior systems analyst, con- 
tributed greatly to the development of 
CUBS. Bayer’s expertise in OS/2 and com- 
munications has won him key roles on a 
number of critical projects at the CME. 


Larry Gavin, manager-systems develop- 
ment, has been on the CUBS project since 
its inception. His background in trading 
systems covers the major Chicago ex- 
changes including CBOE, CBOT, and CME. 


Brian Norquist, senior programmer ana- 
lyst, made critical contributions to the 
CUBS system. His extensive software 
engineering experience, including C++, 
positions him nicely as the lead developer. 


Jim Zeidel, director—systems develop- 
ment, has also been on the project since 
its inception. His extensive industry back- 
ground complements his responsibility 
over a number of trading systems used at 
both CBOT and CME. 





Figure 3. Hide title bar and frame controls (continued on page 94) 
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+ Intercepts WM_TRACKFRAME messages from a standard frame window 

* and prevents moving and sizing when frame controls are hidden. 

* This procedure allows for disabling sizing even when the sizing 

* border is present. 

EREAEAERERARERERE ALES EERE EERER ERE ERES ESLER ERASER EERE ER EREE EAE ARERR EERE ES / 

MRESULT EXPENTRY CubFrameSizingSubProc( HWND hwndFrame, USHORT message, 
MPARAM mp1, MPARAM mp2 ) 








i= 


switch ( message ) 
case WM_TRACKFRAME: 
if ( fFrameControlsHidden ) 
return MRFROMSHORT( FALSE ); 
else 
return ((#sizingFrameProc)( hwndFrame, message, mpi, mp2 )); 


default : 
return ((#sizingFrameProc)( hwndFrame, message, mpi, mp2 )); 


Figure 3. Hide title bar and frame controls (continued from page 93) 
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OS2 TREE” 


See your entire system graphically at a glance! 
"What XTREE GOLD is to DOS and More! 
And What Norton Commander Missed" 

* Completely programmable: every function/key can be 

customized! 

Display your tree structure for all system and LAN disks 

concurrently! 

Manipulate your files, directories, entire disks 

and/or entire system! 

HPFS fully supported 

Pop-up list of files for any directory 

Edit/browse file(s) using any EDITOR or PROGRAM! 
Extensive FILE Search and Tree directory search 

capabilities make locating files and/or data easy. 
Upload/download files between mainframe and PC 

- Secure delete (sensitive files wiped clean) 

Intro Price: $79.99 

Professional Version: $249.99 
Limited time special $150.00 

Network Licenses Available 


LEVINE COMPUTER 
CONSULTING SERVICES 


7640 Provincial Dr., Suite 213, McLean, VA 22102 


Orders only (800) 383-9495 


FAX/Inquiries/HelpLine (703) 790-1660 


















can tap into the source -- the free 
Consumer Information Catalog. It lists 







free and low-cost government 
ublications on cosmic _ such as 
ederal benefits, jobs, health, housing, 
educating your children, cars, and 
much, much more. So dispel the 
darkness and send for the source. 
Write today to Pueblo, Colorado for 
the free Consumer Information 
Catalog. Just send your name and 
. address to : 
Consumer Information Center 
- Department Source | 
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The staff of OS/2 Developer put together this special section to guide you through the various 
computer-based training programs available for OS/2. The products described in this guide are based on 
surveys sent to vendors; they are provided as a service to you and are free to vendors. These listings do 
not represent an endorsement by OS/2 Developer. A/though every effort has been made to ensure accu- 
racy, we do not assume any responsibility for error or omission in this section. Please contact the compa- 


nies directly for more information. 





OS/2 ‘Training 
Buyer’s Guide 


AMERICAN TRAINING 

INTERNATIONAL Circle No. 130 
Teach Yourself OS/2 v2.1 is a self-paced, 
computer-based training program that 
allows both new and experienced users 
to master OS/2 in three to four hours. It 
features a split-screen approach to train- 
ing; the background screen simulates 
OS/2, while a special window provides 
interactive instruction to guide the user 
step by step through OS/2 procedures. 
The user reduces learning time and frus- 
tration by actually performing the skills 
and simultaneously seeing the effects of 
each keystroke. Price: $75.00. 

American Training International, 
12638 Beatrice St., Los Angeles, Calif. 
90066, (800) 955-5284 or (310) 823-1129, 
fax (310) 827-1636. 


ONEONONE COMPUTER 
TRAINING Circle No, 131 
How to Use OS/2 version 2.x is a course on 
four audiocassettes of about two hours 
each that provides the beginning user 
with a hands-on orientation to the sys- 
tem: navigating the desktop, managing 
drives and directories, moving data 
between applications, and file editing. 
Data disk and quick reference guide are 
included. Price: $195.00. 

OneOnOne Computer Training, 
2055 Army Trail Rd., Dept. MF1, 
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Addison, Ill. 60101, (800) 424-8668 or 
(708) 628-0500, fax (708) 628-0550. 


USA TRAINING Circle No. 132 
Working with OS/2 version 2.1 is a four- to 
six-hour video course that focuses on 
features and functions of OS/2, includ- 
ing Workplace Shell’s graphical inter- 
face, This course can help novices learn 
basic concepts and show experienced 
users how OS/2 differs from DOS and 
Windows. Price: $99.00. 

USA Training, 13515 Dulles Tech- 
nology Dr., Herndon, Va. 22071, (800) 
USA-2002 or (703) 713-3813, fax (703) 
713-0065. 


VIAGRAFIX Circle No. 133 
Getting Started with OS/2 gives an 
overview of OS/2, including multitask- 
ing, graphical interfacing, on-line infor- 
mation, Presentation Manager, and boot 
manager. It covers OS/2 fdisk and 
Workplace Shell use, migration, in- 
stalling and running various applica- 
tions, and understanding basic com- 
mands, Fifty-four minutes. Price: $39.95. 

Productivity with OS/2 explains the 
path, the system editor, menus, folders, 
objects, associating programs with 
datafile objects, customizing programs, 
editing icons, adding parameters, 
manipulating objects, making objects 


179594 


on a single issue of OS/2 


OS/2 Developer offers tips and 
techniques for more efficient com- 
puting for the advanced software 
developers who have recognized 
the need for 32-bit power. 


For new orders & customer service: 
1-300-WANT-O32 
(1-800-926-8672) OF 
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FAX (415) 905-2233 
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Skokie, IL 60076-8079 
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from templates, exchanging data 
between sessions, printing, and 
running multiple applications. 
Eighty-seven minutes. Price: 
$49.95. 

OS/2 for your LAN defines local 
area network and gives an over- 
view of LAN server version 3.0. It 
addresses sharing resources, con- 
trolling LAN access, planning a 
network, software, hardware, and 
compatibility questions. It high- 
lights installing the server, re- 
quester, and the DOS LAN re- 
quester. It explains configuration 
concepts of the communication 
environment. Eighty-two minutes. 
Price: $59.95. 

Optimizing OS/2 for HOT 
Performance |looks at CONFIG.SY5, 
the path and libpath commands, 
setting devices, modifying setup, 
and setting application environ- 
ment parameters. This video covers 
file settings, memory management, 
and processor performance. It pre- 
sents how to observe multitasking 
levels, reduce task switching opera- 
tions, improve file system, and 
speed up your system. Sixty-eight 
minutes. Price: $39.95. 

Each video comes with a learn- 
ing disk. Videos can be purchased 
individually or as a set; all four 
videos are $159.95. 

ViaGrafix, 5 5S. Vann St., Pryor, 
Okla. 74361, (800) 842-4723 or (918) 
825-6700, fax (918) 825-6744. 
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If you're looking for a fully configurable, professional OS/2 PM 
programmers editor to replace your current text-mode editor — we 
have what you have been looking for! 


No hassle changing editors 

We know changing editors can be a major hassle. You dont want to 
relearn a new Set of keystrokes no matter how good the product. 

Well, you don’t have to — we have Brief, CUA, Epsilon, Multi—Edit, 
SlickEdit, PWB, and Borland IDE keyboard mappings waiting for you. If 
youre not using one of these, let us know and we will create the 
mapping you need. 


Features designed fo increase productivity 


It has all the features you have come to expect, plus special features 
designed to anticipate your needs and increase your productivity. 
Features like a ‘C’ source browser that eliminates those time 
consuming searches for functions, global variables, typedefs, and 
macros by providing you with instant positioning to both definitions 
and references. Using our powerful ‘C’ macro language you can 
customize your programming environment to suit your individual 
needs. 


RimStar Technology, Inc. Price $299.00 


Partial Feature List 
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Complete ANSI ‘C’ macro language 
SyntaColor™—syntax highlighting 

Smart C/C++ indenting & brace matching 
Bookmarks 

Unlimited undo and redo 

Timed auto save 

Access PDK help for function under cursor 
Multi-threaded for no waiting 

Compile and jump to errors 
Import/export to system clipboard 
Keystroke record/playback 

Block indent/outdent 

Hex editing 

Customizable menus 

Column, line and block 

selection, search and replace 

Integrates with Workframe/2 

Source browser for °C’ 

Template editing 


Multi-bulfer regular expression 
search and replace 


Support for version control 
Complete online help 
Save and restore state between sessions 


OS/2 2.x 32 bit PM Multi-document 
interface 


“My copy of Brief has been permanently _ 





retired, A eee up the goog work? - AL 


91 Halls Mill Road Plus Shipping & Handling. ot registered Faderors of het 

wfields, NH 03856-0938 | , . = = respective holders. RimStar and SyntaColor 
Voice: (603) 778-2000 To order call 1-800-746-7007 ore raddemcaie of Finistor Technology, Inc. 
Fax: 603) 778-2408 60 day money-back guarantee. © 1994 RimStar Technology inc. 


Also available for Winclows and Windows NT 
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The Borland Report on cross-platform development 


~ OWL 1s the cross-platform framework 
with the future built in 


comes to choosing a framework upon 

; : Novell AppWare Fowadaloa 
which to build your applications, you 
know that a good object-oriented 
design is critical to development suc- 


cess. Therein lies the difference 





“OWL isn't just a simple wrapper around Windows API. 
It is a well-designed class library in 
the fullest sense of the word. 
Anything that MFC can do, OWL can do better.” 


1994—Software Development Magazine 


between Borland’s ObjectWindows® 
Libraries (OWL) and Microsoft's 
Macro-based Foundation Classes 
(MFC). OWL is very object-oriented, 
MFC isn’t. 

MFC is not designed with the 
safety that exception handling and 
templates provide. And it’s not archi- 
tectured for the cross-platform future. 

OWL’s superior architecture, inherent safety, and cross-platform 
advantage will make your development efforts more successful. 


OWL has over 200 object-oriented advantages 
Borland’s leadership in object-oriented technology shines throughout 
OWL. Unlike MFC, OWL is not just a thin veneer over Windows API 
calls. OWL delivers real benefits by increasing the reusability, reliability, 
and flexibility of your code. 

What does this mean in coding reality? Suppose you want to make 
a toolbar. If you want a black and white toolbar with 16x15 pixel 
bitmaps using default actions, OWL and MFC are about the same. But 
don’t be fooled. Suppose you need larger buttons? Suppose you need an 
edit field in your toolbar? Or you need to add new functionality to a sta- 
tus bar? OWL gives you immediate object-oriented flexibility. 
MFC doesn't. 

And this is just one example. With over 200 classes, 
encapsulating everything ranging from display contexts 
to print preview windows, OWL will keep you on the 
object-oriented fast track. 


Be safe 

If your code is your livelihood, you want 
to make sure your code is safe. No questions. 
OWL is designed from the ground up with 
exception handling built in. So if something 





Circle Reader Service Number 44 


| REUSABLE COMPONENTS FOR | COMPONENTS FOR 





| CROSS-PLATFORM DEVELOPMENT | | CROSS-PLATFORM DEVELOPMENT | DEVELOPMENT 





Borland 


The Upsizing Company 


a unexpected happens, you have 


2 it se _ — the power of C++ backing you up. 
‘a — “ You can easily add specialized 
ee Wina2 API error handling. You can easily 
a | correct problems. All without 
a | Windaws inelegant return value checks and 


al 


= — other “out of date” error 
approaches. And if you don’t 
write your own handlers, OWL’s 
built-in handlers will take care of 
the problems for you, with full 
stack unwinding and destructor 
calling, for safe cleanup. 





Get the cross-platform advantage 

ObjectWindows 2.0 is the foundation for ObjectWindows for 
AppWare, a true cross-platform solution for Windows, Windows NT, 
Chicago, OS/2,® Macintosh, and UNIX. So you develop your code 
once, and deploy it on whatever platforms you need. While at the same 
time leveraging the capabilities of each target platform. 

OWL for AppWare is being built upon two proven, successful 
products, ObjectWindows and Novell's AppWare Foundation. Join the 
ObjectWindows for AppWare Early Experience Program and get 
started with cross-platform development today. 


Buy Borland C++ 


Borland gives you easy access ta FREE 


to the information you need 
Download the full 60-page OWL vs. MFC 
comparison paper from one of these on-line services: 

¢ Borland Forums on CompuServe, BIX, GEnie 

e Borland Bulletin Board (408) 431-5096 

¢ Through Internet via anonymous ftp at ftp.borland.com 


Training Course 


Compons available tor Cs. 
Traineng Courue at good bocal recefler 





Join the OWL for AppWare Early Experience Program 
e Call now (408) 431-1507 





Subscribe to Borland’s free electronic newsletter and get 
a regular update on the hottest programming tips and tricks. 
« For more information, send an electronic 

mail to tech-info@ borland.com 


Buy Borland C++ Today and put OWL 2.0 to work 


for you. Call: 1-800-645-4559, ext. 8930 


CALL NOW 1-800-645-4559, EXT. 8930 
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